Handbook Talk:AMD64/Installation/Base
Before creating a discussion or leaving a comment, please read about using talk pages. To create a new discussion, click here. Comments on an existing discussion should be signed using
~~~~
:
A comment [[User:Larry|Larry]] 13:52, 13 May 2024 (UTC) : A reply [[User:Sally|Sally]] 16:19, 10 December 2024 (UTC) :: Your reply ~~~~
Some closed discussions have been moved to an archive subpage: Handbook Talk:AMD64/Installation/Base/Archive.
provide info or different protocols for mirrors and how many to add
It isn't made clear what the pros and cons of the different protocols are, so I was left wondering which one is fastest/most secure. Also maybe there should be a recommendation of how many mirrors to add. MihailMihov (talk) 21:35, 7 March 2024 (UTC)
- Not sure there is a need for this on, can you please show an example of this would look in Template:Proposal to help explain the benefits?
- Immolo (talk) 11:50, 8 March 2024 (UTC)
command to list timezones references parent directory
the command ln -sf ../usr/share/zoneinfo/Europe/Brussels /etc/localtime
seems to assume that the user is not in / (why would it?) or is this just a typo? MihailMihov (talk) 21:39, 7 March 2024 (UTC)
- The Handbook is designed to always teach users the correct way so while you are techicnally correct, we shouldn't make this change and cause an unforeseen issue.
- Immolo (talk) 11:50, 8 March 2024 (UTC)
- I don't think that I explaind myself correctly. I'm not saying to use relative paths, in fact I don't see why the locale is referenced as such. Why
../usr
instead of/usr
? MihailMihov (talk) 13:03, 8 March 2024 (UTC)
- I don't think that I explaind myself correctly. I'm not saying to use relative paths, in fact I don't see why the locale is referenced as such. Why
- After speaking to User:floppym it's clear this change isn't required for soft linking so am returning this closed based on that discussion.
- Immolo (talk) 19:10, 16 March 2024 (UTC)
- Symlink targets are always evaluated relative to their position in the filesystem, so the working directory isn't relevent when calling "ln -s" with an absolute path as the last argument.
- We generally try to avoid using absolute paths in symlink targets since that can cause problems when working with alternate ROOT directories. In this particular case it probably wouldn't matter.
- --Floppym (talk) 19:17, 16 March 2024 (UTC)
example shows selecting the POSIX locale, but that causes issues in desktop environments
there is a warning that atleast one utf 8 locale must be built, but no warning that following the example and selecting POSIX will cause issues with graphical applications. MihailMihov (talk) 21:44, 7 March 2024 (UTC)
- Fixed in Special:Diff/1288877/1288884, thanks!
- --Xarvatium (talk) 19:23, 16 March 2024 (UTC)
Example for binary package host example has inconsistent naming
The example for the binary package host is in the location /etc/portage/binrepos.conf/gentoo.conf while the location in the Binary Host Quickstart points to /etc/portage/binrepos.conf/gentoobinhost.conf, and some users might find this confusing.
WavyEbuilder (talk) 21:22, 15 March 2024 (UTC)
- To add this issue was found by a new user that got confused, so this is a needed changed.
- Proposed changes - Please make edits here until a final revision is agreed upon.
A second important step in selecting mirrors is to configure the Gentoo ebuild repository via the /etc/portage/repos.conf/gentoobinhost.conf file. This file contains the sync information needed to update the package repository (the collection of ebuilds and related files containing all the information Portage needs to download and install software packages). - Immolo (talk) 21:29, 15 March 2024 (UTC)
- Fixed in Special:Diff/1287348/1288665, thanks!
- --Xarvatium (talk) 21:34, 15 March 2024 (UTC)
Mentions of 17.1 profiles should be changed to 23.0
Now that the stage 3 files have been updated to use 23.0 profiles, I think it should be time to update any mentions of 17.1 profiles to 23.0, as I believe it could in some cases clear up confusion for some users who are installing Gentoo for the first time.
--MymeType (talk) 23:41, 27 March 2024 (UTC)
- AMD64 bumped in Special:Diff/1282566/1289968
- --Xarvatium (talk) 23:56, 27 March 2024 (UTC)
- I see no more occurrences of 17.1. Closing. Waldo Lemmer (talk) 12:30, 1 April 2024 (UTC)
Please delete this: "# May have been created in a previous step"
Change 2 of 2: (the 1st change was in "Preparing the disks"). Please delete this: "# May have been created in a previous step" from this line (ONLY the text; NOT the command):
root # mkdir /efi # May have been created in a previous step
-- Pietinger 14:58, 17 April 2024 (UTC) with help from @negril in IRC TODAY
- Fixed in Special:Diff/1294705/1298156, thanks!
- --csfore (talk) 18:44, 11 May 2024 (UTC)
FEATURES is an incremental variable
Since FEATURES is an incremental variable, instructions under "Installing binary packages" should be updated as follows:
# Install binary packages when available FEATURES="getbinpkg" # Require signatures FEATURES="binpkg-request-signature"
See: FEATURES --Lucatrv (talk) 13:37, 1 May 2024 (UTC)
- I don't think this is right. It's incremental across scopes, not within the same file. --Sam (talk) 22:08, 2 May 2024 (UTC)
- Yes sorry, of course you're right, I update my suggestion:
# Install binary packages and require signatures FEATURES="getbinpkg binpkg-request-signature"
--Lucatrv (talk) 21:25, 3 May 2024 (UTC)
Missing step to remove /etc/localtime
Tip: To get this fixed sooner, use {{Proposal}}.
When configuring the timezone, a warning appears about /etc/localtime
being a file instead of a symlink:
$emerge --config sys-libs/timezone-data * Found a regular file at /etc/localtime. * Some software may expect a symlink instead. * You may convert it to a symlink by removing the file and running: * emerge --config sys-libs/timezone-data * Copying /usr/share/zoneinfo/America/New_York to /etc/localtime.
It seems like perhaps there should be a step to remove /etc/localtime
before running emerge --config sys-libs/timezone-data.
GuyEP (talk) 03:45, 21 May 2024 (UTC)
- I'm linking this discussion here because it seems related.
- — Waldo Lemmer 04:53, 21 May 2024 (UTC)
Please explain relative path meaning for symlinks
The Gentoo Handbook should address inexpert users too, so please after "ln -sf ../usr/share/zoneinfo/Europe/Brussels /etc/localtime" add an explaining note such as: "The target path with `../` at the start is relative to the link location, not to the current directory". See for instance: https://wiki.archlinux.org/title/Systemd-resolved#DNS --Lucatrv (talk) 22:19, 1 June 2024 (UTC)
- Proposed changes to section systemd - Please make edits here until a final revision is agreed upon.Note
The target path with../
at the start is relative to the link location, not necessarily to the current directory.
--Lucatrv (talk) 13:18, 2 June 2024 (UTC)
- I added the word "necessarily". Most guides cd to the link location, which makes the link location and current directory the same.
- Looks good to me :)
- — Waldo Lemmer 13:54, 2 June 2024 (UTC)
- Fixed in Special:Diff/1313977/1313983, thanks!
- --csfore (talk) 15:24, 20 September 2024 (UTC)
Clarify chrooting section
In the "Chrooting" section, in the "Mounting the necessary filesystems" subsection there is a tooltip saying that "this" steps can be skipped and "arch-chroot" used instead, but it is unclear what steps can be skipped and where the reader should resume. The proposition is to move this tooltip to the very top of the "Chrooting" section, and change it to something like: "If using Gentoo's install media You can make below actions with a convenient script called arch-chroot, and then resume at the "Preparing for a bootloader" subsection + the command itself below". --Shvrma (talk) 12:34, 6 June 2024 (UTC)
- I agree. The "If using Gentoo's install media" tip should be moved upwards to directly below the Mounting the necessary filesystems heading.
- — Waldo Lemmer 04:51, 7 June 2024 (UTC)
- Fixed in Special:Diff/1313983/1313985, thanks!
- --csfore (talk) 15:27, 20 September 2024 (UTC)
repo verification
I think it should be pointed out that the use of "emerge-webrsync" and "emerge --sync" comes along with cryptographic verification. Otherwise, the unknowing newbie might think, it's, for example, only plain stupid rsync.
--Duxsco (talk) 21:16, 6 September 2024 (UTC)
More including tips for desktops
I think maybe more explanation about desktop installation - maybe a couple of links to common desktop environment wikis. The existing selection of the contents of the desktop profile is basically useless - it does not provide a usable desktop. Df1050 (talk) 09:00, 9 October 2024 (UTC)
- I feel like I need to explain: I think that if the handbook really only installs the base system, it should choose the minimal profile and explain the desktop installation. Otherwise, write out the full desktop installation process, which should also be a link. Df1050 (talk) 09:05, 9 October 2024 (UTC)
Mention that GENTOO_MIRRORS does not need to be set
As noted by someone on gentoo-user, the "Optional: Selecting mirrors" section isn't clear: it doesn't mention that, if GENTOO_MIRRORS is not set, distfiles.gentoo.org will be used by default. This can lead to confusion, as a section marked as 'Optional' appears to be saying that one should manually specify a mirror. Thus, i suggest changing the opening text of that section to:
By default, Gentoo will download source from distfiles.gentoo.org. However, it is also possible to manually specify a mirror by setting the GENTOO_MIRRORS variable in make.conf; Portage will then try to use the mirror(s) listed in that variable.