Gentoo Legion Installer
Automated Gentoo Linux installer for Lenovo Legion laptops with AMD + NVIDIA hybrid graphics.
Features
- Python-based installer with idempotent operations (safe to re-run)
- LUKS2 encryption with Btrfs subvolumes
- Hybrid GPU support (AMD iGPU + NVIDIA dGPU)
- OpenRC init system
- Hyprland desktop environment (optional)
- Fingerprint authentication for Elan readers (optional)
Hardware
Tested on Legion S7 15ACH6:
- AMD Ryzen 9 5900HX
- AMD Radeon Vega (iGPU)
- NVIDIA GeForce RTX 3050 Ti Mobile (dGPU)
Should work on other Legion models with similar hardware.
Quick Start
# Boot Gentoo live environment, then:
git clone https://github.com/<your-username>/gentoo-legion-python /root/gentoo
cd /root/gentoo
python setup.py --install
See procedure.md for complete installation guide.
Repository Structure
.
├── setup.py # Main installer entry point
├── procedure.md # Complete installation guide
├── install/ # Python installer modules
│ ├── disk.py # LUKS + Btrfs setup
│ ├── stage3.py # Stage3 download/extract
│ ├── sync.py # Portage sync, profile, locale
│ ├── services.py # OpenRC services setup
│ ├── users.py # User creation, shell config
│ ├── nvidia.py # NVIDIA driver setup
│ ├── bootloader.py # GRUB installation
│ └── fingerprint.py # Fingerprint auth (optional)
├── portage/ # Portage configuration
│ ├── make.conf
│ ├── package.use/
│ ├── package.accept_keywords/
│ └── sets/ # @hyprland package set
├── dracut.conf.d/ # Initramfs configs
├── conf.d/ # OpenRC service configs
├── iptables/ # Firewall rules
├── hypr/ # Hyprland configs
├── .zshrc # Shell configuration
└── starship.toml # Prompt theme
Customization
Before running, you may want to customize:
- portage/make.conf - CPU flags, mirrors, features
- install/sync.py - Timezone, locale, hostname
- install/disk.py - Swap size, partition layout
- iptables/*.rules - Firewall rules for your network
License
MIT License - See LICENSE