gein

gein is a collection of files driven by a shell script that (somewhat) automates installing Gentoo.

Warnings

Usage

  1. Prepare a disk or USB drive

    gein should work from almost any live installation media, though Fedora Workstation or Ubuntu Desktop will most likely be best if you wish to continue using the system while you wait.

  2. 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. If you aren’t using the Gentoo installation CD, you will need to run mkdir /mnt/gentoo before performing these steps:

     $ fdisk /dev/sda
     $ mkfs.xfs /dev/sda1
     $ mount /dev/sda1 /mnt/gentoo
    
  3. Download gein.sh:

    You should be able to run the script from anywhere, but in general it may be best to sudo -i and cd ~/ so that you are a privileged user.

     $ wget https://raw.githubusercontent.com/jcmdln/gein/master/gein.sh
     $ sh gein.sh
     gein: Gentoo minimal installation script
       -b. --bootstrap    Bootstrap the stage3 tarball
       -i, --install      Install Gentoo
    
  4. Bootstrap the system

    Now we can bootstrap the system:

     $ GEIN_PARTITION_BOOT="/dev/sda" sh ./gein.sh --bootstrap
    

    Once the boostrap process finishes, you will be in a chroot within /mnt/gentoo where you may proceed to the next step. Your new chroot has all the GEIN_* environment variables as you defined them.

  5. Install the desired target

     $ sh ./gein.sh --install
    

    At the start of the installation you’ll be prompted to create a root password and pick your profile.

  6. Wait

    If you used a LiveCD then kill some time while you wait. Enjoy your new Gentoo installation!

Contributing

I’m very interested in feedback regarding the contents of this repo. If you have any feedback, suggestions, or contributions please file an issue or pull request.