# Easy Gentoo

Easy Gentoo is free software distributed under the terms of the MIT license.
For license details, see LICENSE.

---------------------------------------------------------------------
**WARNING:**
**THERE MAYBE SOME MISTAKES OR PARTS THAT NEED IMPROVING.**
**I RECOMMEND YOU TO TEST THIS SCRIPT IN A VIRTUAL ENVIRONMENT FIRST.**
**DON'T FORGET TO CROSS FINGERS WHILE USING ON A REAL MACHINE :)**
---------------------------------------------------------------------

Bash script for easy Gentoo Linux installation

"Easy Gentoo" is a bash script, which is basically a combination of
Gentoo Handbook steps, that installs Gentoo Linux from a stage3 tarball.
The overall procedure is unattended, everything is handled by script.
Installation includes "localization (English, Brazilian and Turkish),
kernel compilation, X server setup, desktop environment setup (Xfce)"
and more. These steps are enabled or disabled according to a profile.

Profile is a simple text file which has the necessary options, settings
etc. for the installation. (Profile must be named as "profile") With
a proper profile, it is possible to have a basic system (without X) or
a ready to use Xfce desktop with a few key strokes.

"Easy Gentoo" was tested on lots of machines with different profiles.
Many successful installations were made. Hope it becomes a time-saver
for you. Happy compiling!

## Important Notes
- Easy Gentoo doesn't do partitioning, you need to do that by yourself. It formats and mounts your selection of existing partitions.
- Using a capable intallation media which has more filesystem utilities, Easy Gentoo can format, mount, configure partitions for these filesystems: "btrfs, ext2, ext3, ext4, ntfs, reiserfs, xfs"
- Localization is based on your "keymap". "us" is for English, "br" is for Brazilian, "trq" and "trf" are for Turkish.
- A temporary swap file with 1 GB size is created as a precaution if root partition is bigger than 8 GB
- There are two install types; basic:   doesn't include X,LightDM,Xfce,Alsa,NetworkManager,  normal:  includes X,LightDM,Xfce,Alsa,NetworkManager. Base system configuration is the same for both.
- Easy Gentoo needs an ethernet connection to operate, wireless connection is not an option for now.
- If the host computer is a laptop, some USE flag changes and additional package merges are made (these have nothing to do with wireless)
- Stable packages are used
- Based on a stage3 tarball (latest one)
- CFLAGS="-march=native -O2 -pipe"
- LDFLAGS="-Wl,-O1 -Wl,--as-needed -Wl,--sort-common -Wl,--hash-style=gnu"
- Mirrors for Turkish users:

http://ftp.linux.org.tr/gentoo   ftp://ftp.linux.org.tr/gentoo   ftp://mirrors.linuxant.fr/distfiles.gentoo.org

- Mirrors for other users:

ftp://mirrors.linuxant.fr/distfiles.gentoo.org   http://gentoo.supp.name   http://portage.org.ua

- Portage profile is "${arch}/13.0/ for basic install" and "${arch}/13.0/desktop for normal install"
- Kernel has lots of drivers activated to help to get an error free first boot
- Grub2 is used, not Grub legacy
- No system logger and no cron included
- A few performance and security related sysctl settings are included
- sudo configuration and some aliases are included
- File manager is Thunar with automount support
- Login Manager is LightDM

## After Using Easy Gentoo, you should check/change these
- Timezone
- Grub config (parameters, title)
- Startup services
- USE flags (default ones may not be enough for you)
- Mirrors
- Kernel config (it is recommended to compile a new kernel with a customized config)
- Compile list (to check if your 'must have' ones are installed)

## How to use
- boot from an installation media (ex. Gentoo Minimal Install CD)
- execute these commands:

wget https://raw.githubusercontent.com/shdcn/easygentoo/master/easygentoo

chmod +x easygentoo

- create a profile in the same directory where script is placed

for more information on profile please read:

https://github.com/shdcn/easygentoo/blob/master/profile

- start script:

./easygentoo

## Steps for basic install
- Check if necessary tools/commands are available to continue
- Format partitions
- Mount partitions
- Check mirrors
- Download and extract latest stage3 tarball and portage snapshot
- Continue inside chroot
- Create a temporary make.conf
- Emerge portage and some tools
- Create locale.gen
- Update make.conf and create package.use
- Do a controlled "emerge -e system"
- Kernel compilation (genkernel-next) with lots of needed settings/drivers
- Emerge grub2 and create grub.cfg
- Create/update configuration files (localtime, keymaps, hostname, etc)
- Change locale based on keymap
- Change root password and create user
- Update /etc/sudoers and .bashrc
- Unmerge unnecessary packages and do "emerge -uDN world"

## Steps for normal install

- Emerge xorg-server and create xorg.conf
- Emerge and configure Xfce
- Emerge and configure LightDM
- Configure evdev
- Emerge NetworkManager
- Emerge and configure Alsa

## End of normal install steps

- Purge unnecessary man pages etc. (localepurge)
- Create a small report about whole process.
- Delete temporary files that were created by script
- Shutdown computer