Handbook:Main Page

Introduction
The Gentoo Handbook is an effort to centralize documentation into a coherent handbook. This handbook contains the installation instructions for Internet-based installation approaches and parts about working with Gentoo and Portage.

Architectures
Gentoo Linux is available for many architectures. But what exactly is an architecture?

An architecture is a family of CPUs (processors) who support the same instructions. The two most prominent architectures in the desktop world are the architecture and the x86_64 architecture (for which Gentoo uses the  notation). But many other architectures exist, such as, (the PowerPC family), , , etc...

A distribution as versatile as Gentoo supports many architectures. For that reason, you'll find that our Gentoo Handbooks are offered for many of the supported architectures. However, that might lead to some confusion as not all users are aware of the differences. Some are only aware of the CPU type or name that their system is a part of (like i686 or Intel Core i7). Below you will find a quick summary of the supported architectures and the abbreviation used in Gentoo. However, most people that do not know the architecture of their system are mostly interested in or.

Can't you magically have the handbook dynamically created for each choice?
Everything is possible, but we have opted to only do this on a per-architecture level. Other choices, like partitioning, kernel selection, tool installation and more are easy enough to explain in a single document.

I can't find stage1 information in the Gentoo handbook
Instructions on using a stage1 or stage2 tarball are now available in the Gentoo FAQ. A stage3 installation is the only supported installation as of now.

Continual Handbook improvement
Suggestions, comments, or ideas on how to make the Handbook better can be reported to the Handbook project via the Discussion page of the respective article. Documentation is made for the community, so community feedback is well appreciated.

Be aware that most decisions made while developing documentation are based on a consensus-model. It is impossible to write or structure documentation in such a way that renders every reader happy.

Those who open discussions with the goal of improving the Handbook must be able to accept a "No" as an answer. Typically "No" is used we believe the current implementation is beneficial for the majority of readers.

In order to properly track open issues we ask you to add the Talk template to each discussion you open, as seen in the following example:

Please also remember to sign your discussion using the Signature and timestamp button in the text formatting toolbox.