note: this page assumes you have some experience with linux and that you know what hardware you have in your computer. if not, i highly suggest gaining some experience or checking your specs before running gentoo.
gentoo linux is my favorite linux distribution for my use case, second place going to arch, and third going to debian. being source based with things like use flags and a more complicated package manager (portage) than most distributions, some say gentoo has a steep learning curve. with linux experience and a capable computer you can run gentoo rather easily, even on exotic hardware (though kernel configuration may be difficult).
all you really need is basic knowledge and a computer capable of compiling. while you can install gentoo on a slower or low spec machine, it may take much longer to compile everything.
make sure to follow the gentoo handbook when installing, and only use 3rd party installation videos or instructions as secondary resources. this is because everyone's system will be different, and using someone else's configurations may not be best for you, or may not even work on your hardware.
decide what kind of system you want. do you want a desktop environment? do you want to use systemd or openrc? pulseaudio or alsa? are you running gentoo on a server? do you need new software? consider these things when configuring portage.
this is what caused me the most problems starting out,
since i have a rather old and obscure IDE/SATA controller,
which i had to dig around for. if you're having problems,
if you're running a linux system already (can be a livecd),
lspci -k to see various hardware and the
corresponding kernel modules. look up the kernel modules
if anything isn't working. i got kernel panics because
because my IDE controller wasn't supported, so the linux kernel
couldn't find or mount my root filesystem (kernel panic: unable
to mount root filesystem). when running any custom compiled linux
kernel, make sure you have things like that enabled first.
you can worry about things non-essential to boot later, but
it is rather difficult to get non-essential things working
when your computer can't boot. when i tried to install kiss
linux i had the same problem, and you can read my reddit post
it's a good idea to read the help section for each option. you also may be able to get away with not using an initramfs if you don't need to load modules on startup. it's a good idea to start with an initramfs and try removing it later, so build one at first.
note: make sure to use
-j(number of cpu cores) when
compiling the kernel to reduce build times.
since gentoo is a source based distribution, the source code downloaded
to install packages will cause the root filesystem to become full faster
than on other binary distributions. using
eclean you can
remove the extra files on your system.
# all of this should be done as root using sudo or doas # to clean packages eclean-dist -d # to remove n number of old kernels eclean-kernel -n [number]
a list of useful software:
app-portage/gentoolkit - portage utils
app-portage/cpuid2cpuflags - get CPU_FLAGS
if you want to use a cross compiler on gentoo for whatever reason (typically operating system development),
gentoo provides a package you can use to set it up (
sys-devel/crossdev). you can read the wiki page
if you want to get your -march right the first time, use this page
to get it correct for your cpu. trust me, i had to recompile my entire system because i used
-march=native instead of