Gentoo installation script
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
jcmdln 0e062f7cc1 Advise to submit an issue if arch not found 4 years ago
etc make.conf: Switch to -O2 4 years ago
usr/src/linux Add linux 4.16 config 4 years ago
CNAME Advise to submit an issue if arch not found 4 years ago

gein (GEntoo INstaller) is a script for automating the installation of my ideal Gentoo Linux system. This repository contains the following:

  •, the installation script
  • etc/, configuration files
  • usr/, kernel configurations


  • Using gein is not a replacement for reading the Gentoo Handbook. If anything is not understood, please consult the Gentoo Handbook for your system before submitting an issue.
  • Be sure to review this repository in it's entirety, including the warnings at the top of
  • You must manually partition your disks and mount the partitions.
  • No web browser, office suite, or other applications are included by default.


"How much about Gentoo will I need to know to use gein?"

I would suggest reading the Gentoo Handbook and every file in this project before proceeding.

"I keep getting boot failures after installing in a VirtualBox VM?"

Remove the virtual disk drive from the boot order and restart.

"The display is lagging when using LXQT on my Nvidia GPU?"

Run eselect opengl set nvidia as root.


You may use this script as-is by performing the following steps:

  1. Download the latest Gentoo install cd for your architecture. Only amd64 is currently defined. Create an issue with the output of uname -a for it to be added to the script.

  2. Write the ISO to a disk or USB drive and boot from it.

     $ dd if=~/Downloads/install-*.iso of=/dev/sdX
     $ reboot
  3. Partition and mount your disks. Note that this example assumes that you will be using a single partition and later installing GRUB to the MBR.

     $ fdisk /dev/sdX
     $ mount /dev/sdX1 /mnt/gentoo
  4. Download and run

     $ wget
     $ sh
     gein: Linux-based derivative of Gentoo
       bootstrap    Bootstrap the stage3 tarball
       base         Basic headless server & development
       minimal      X, i3wm, and base packages
       complete     A complete LXQT Gentoo desktop
  5. Uncomment and set the PartitionBoot & VideoCards variables. Both MUST be set or will exit. If you don't need any video support, then set VideoCards to false.

     VideoCards="i915 i965 intel"
  6. Start the bootstrap. Upon completion, the script will chroot into /mnt/gentoo so we may proceed to the next step.

     $ sh ./ bootstrap
  7. Install the desired target:

     $ sh ./ minimal
  8. Wait a few hours. You will be prompted as few times as possible, and as close to the beginning or end of the process.

  9. Enjoy your new Gentoo installation!


If you would like to create your own ideal Gentoo system using this script, you may do so by:

  1. Forking
  2. Modify the configuration files as desired
  3. Update the Source URL in
  4. Update the CONFIG() function to represent your configuration