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.
John ae4994c0d7 hard-code ProfileFilter
4 years ago
CNAME Cleanup pass 4 years ago hard-code ProfileFilter 4 years ago

gein is a script which installs Gentoo Linux. The primary goal is to automate the installation of my own ideal Gentoo setup though the current design allows for others to fork or submit PR's should it be desired.

You may review the source code at for more information if needed.


  • "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.


  • gein is NOT a replacement for reading the Gentoo Handbook.
  • gein is NOT a one-size-fits-all solution.
  • Read the warnings at the top of FIRST!
  • Review all of the files in this repository before using.
  • You must manually partition and mount your disks.
    • Consult your Gentoo Handbook.
  • gein does not install a web browser or office suite.


  1. Create your Gentoo installation media.

  2. Partition and mount your disk(s).

  3. Download and run

     $ wget
     $ sh
     gein: Linux-based derivative of Gentoo
       -h, help         Shows this output
       -b, bootstrap    Bootstrap the stage3 tarball
       -m, minimal      Perform a basic Gentoo installation
       -d, desktop      Install a gein desktop
         i3wm           A complete i3wm desktop
         lxqt           A complete LXQT desktop
  4. Read the information at the top of and modify the variables as needed:

     $ vi
  5. Start the bootstrap:

     $ sh bootstrap
  6. Install your desired variant:

     $ sh desktop

Enjoy your Gentoo installation!