Handbook Talk:AMD64/Installation/System

Missing underscores
I have found two errors in the section "Configuring the network", there are two missing "_" in the followed sections:

Static IP definition: routes eth0="default via 192.168.0.1" should be routes_eth0="default via 192.168.0.1"

DHCP definition: config eth0="dhcp" should be config_eth0="dhcp"

The printable version is OK.


 * Um. Maybe you're using a weird monospaced font. Looks alright here: http://puu.sh/jGXzu/dc264e238b.png —a3li 14:09, 19 August 2015 (UTC)

We need an example with partition labels
I tried to follow the handbook, but I messed up here when I tried to use partition labels. It turns out that fstab will let you use either FSA labels or partition labels. You use LABEL= for an FS label, or PARTLABEL= for a partition label. Since this page recommends the use of partition labels, it should provide an example. -Arch dude (talk) 04:38, 9 March 2017 (UTC)


 * You may not (yet!) have noticed, but the new stage3 tarball contains a new set of examples how these should be implemented, but I would agree that some more information in the Handbook would be helpful. I know the Wiki team have this section on their TODO list, so hopefully you will see changes in the coming weeks/months :) -- veremit (talk) 14:36, 9 March 2017 (UTC)

The network section is not valid anymore
By default the new system uses predictable network interface names so the section should be updated to show the command that retrieves the predictable name and the config file modification and init file should be updated accordingly. --fordfrog 11:02, 19 December 2017 (UTC)

Indicate numpad support under "Init and boot configuration"
On multiple installs that I have done, I ended up with systems that didn't support the numerical keypad. I recently learned that this can be enabled by editing the /etc/conf.d/keypads file. The change is to add the keypad option to the extended_keymaps variable. Perhaps the handbook should call attention to this.


 * Did you mean to edit the file instead?--Charles17 (talk) 07:13, 2 February 2018 (UTC)


 * Yes, I did. My apologies for any confusion.

Use a more direct language to clarify mount option (minor)
This is also recommended for solid state drive (SSD) users to enable the discard mount option (ext4 and btrfs only for now) which makes the TRIM command work.

Raphexion (talk) 06:44, 30 March 2018 (UTC)


 * This is actually a user preference as it can impact performance. A user may elect to run fstrim by hand or in a cron jobs.  It is also not limited to ext4 and btrfs. --Grknight (talk) 18:36, 27 October 2018 (UTC)


 * After I posted the above, I noticed the text already includes this. --Grknight (talk) 18:39, 27 October 2018 (UTC)

missing information?
The Gentoo Handbook is excellent! Thanks. While installing Gentoo, I am just following the handbook step by step, and didn't have to take any notes! The only point of confusion upto this point is this: For the hostname and domainname, the Handbook suggests editing /etc/conf.d/hostname and /etc/conf.d/net. Is that sufficient? Other sites (elsewhere) say that you should edit /etc/hostname too. (/etc/hostname has not been mentioned anywhere in the Handbook till now.) Niku (talk) 06:28, 17 December 2018 (UTC)


 * Gentoo's default OpenRC install does not use /etc/hostname which is what the handbook covers. It is true that a systemd install would use it but there is  to easily edit it and signal systemd --Grknight (talk) 13:42, 17 December 2018 (UTC)

Wrong description of 'filesystem type' field
In section ' Creating the fstab file':

'# The third field shows the filesystem used by the partition.'

should be

'# The third field shows the type of the filesystem used by the partition.'

-Mike155 (talk) 17:49, 7 November 2019 (UTC)