Installation

The current version of Gentoo Studio is an open beta. Your feedback will be appreciated, and can be provided here.

Note for UEFI: Please make sure you understand how to boot your computer with UEFI and load a non-Windows OS if you have a UEFI machine. It is beyond the scope of this guide to assist with that.

Acquire a boot medium. The recommended boot medium is SystemRescueCd. You can use any boot medium that gives you access to your hard drive and allows you to chroot. If using SystemRescueCd, select option C for standard 64-bit kernel, then option 1 for default options. If you are using something else, make sure you boot with a 64-bit kernel. You do not need to startx.

The automated and manual installs result in exactly the same system and use exactly the same commands. The manual install is provided for the DIY enthusiasts. In either case, installation is only intended for computers that will be running only Gentoo Studio and on which the primary hard drive contains no data you wish to keep. During the open beta, I will look into expanding dual-boot and alternate hard disk installations based on user feedback. The primary goal, though, is to make sure the installation process works for various hardware configurations.

Currently, only the amd64 architecture is supported.

Note: The “basic” flavor will be dropped. Please choose between complete and minimal.

Automated Install

  1. wget https://gentoostudio.org/src/builds/install.sh
  2. chmod +x install.sh
  3. ./install.sh
  4. Follow instructions and prompts

For a minimal install, use https://gentoostudio.org/src/builds/minimal/install.sh in step 1 above.

Manual Install

  1. Once you’ve booted with your boot medium, you need to prepare the hard drive using the following steps:
    1. parted -a optimal /dev/sda
    2. mklabel gpt
    3. unit mib
    4. mkpart primary 1 3
    5. name 1 grub
    6. set 1 bios_grub on
    7. mkpart primary 3 131
    8. name 2 boot
    9. mkpart primary 131 643
    10. name 3 swap
    11. mkpart primary 643 -1
    12. name 4 rootfs
    13. set 2 boot on
    14. print
      • You should see this:
        Number Start  End    Size   File system    Name  Flags
        
         1     1049kB 3146kB 2097kB                grub  bios_grub
        
         2     3146kB 137MB  134MB  ext2           boot  boot, esp
        
         3     137MB  2235MB 2097MB linux-swap(v1) swap
        
         4     2235MB 2000GB 1998GB ext4           rootfs
    15. quit
    1. If you have a BIOS system: > mkfs.ext4 /dev/sda2
    2. If you have a UEFI system: > mkfs.vfat /dev/sda2
  2. mkfs.ext4 /dev/sda4
  3. mkswap /dev/sda3
  4. swapon /dev/sda3

Now mount the hard drive and install the base system:

  1. mount /dev/sda4 /mnt/gentoo (The mount point does not matter. Just substitute whatever you use here.)
  2. mkdir /mnt/gentoo/boot
  3. mount /dev/sda2 /mnt/gentoo/boot
  4. cd /mnt/gentoo
  5. wget https://gentoostudio.org/src/builds/complete/stage4-amd64-latest.tar.bz2
  6. tar xvjpf stage4-amd64-latest.tar.bz2 –xattrs
  7. rm stage4-amd64-latest.tar.bz2

Chroot into the base system and configure:

  1. cp -L /etc/resolv.conf /mnt/gentoo/etc/, y to overwrite
  2. mount -t proc proc /mnt/gentoo/proc
  3. mount ‐‐rbind /sys /mnt/gentoo/sys
  4. mount ‐‐rbind /dev /mnt/gentoo/dev
  5. chroot /mnt/gentoo /bin/bash
  6. source /etc/profile
  7. emerge-webrsync
  8. eix-sync
  9. ls /usr/share/zoneinfo
  10. echo “(selected timezone)” > /etc/timezone
  11. emerge –config timezone-data
  12. nano -w /etc/locale.gen
  13. locale-gen
  14. eselect locale list
  15. eselect locale set x, where x is your desired locale
  16. source /etc/profile
    1. If you have a BIOS system: > grub-install /dev/sda
    2. If you have a UEFI system: > grub-install –efi-directory=boot /dev/sda
  17. grub-mkconfig -o /boot/grub/grub.cfg (This will be a new file.)
  18. passwd (Sets root password.)
  19. useradd -m -G users,wheel,audio -s /bin/bash (username)
  20. passwd (username)
  21. cpuinfo2cpuflags-x86 >> /etc/portage/make.conf
  22. emerge -vuDN –keep-going –with-bdeps=y –backtrack=1000 @system @world (This recompiles any packages that use CPU-specific flags.)
  23. reboot

You should now have a working Gentoo Studio workstation according to the installation package you used.

Notes:

Do NOT update /etc/security/limits.conf. Those settings are there for a reason.