Portage with Git
This article will explain how to use Git to synchronize the Gentoo ebuild repository.
Prerequisites
From version 14-r1 (available 2024-12-09), eselect-repository enables
+git USE flag by default. If you want to use git synchronization, you must NOT disable this flag.eselect-repository and Git must be installed; see their respective articles for installation instructions.
To reduce the risk of issues, it's recommended to sync the Gentoo repository before starting this process, and ensure that the system is using the latest profile.
Setup
Start by disabling the old Gentoo ebuild repository configuration:
root #eselect repository disable gentooUpdating repos.conf ... 1 repositories disabled
If the obsolete variable PORTDIR is defined in make.conf (which may be the case on older Gentoo installations), remove that definition as well.
If the system is old enough to have PORTDIR set to /usr/portage/, this is an excellent opportunity to migrate it to use more modern paths. Take note of the current profile by running eselect profile show, then delete the definition of PORTDIR and any other variables in make.conf which reference paths under /usr/portage/. The rest of these instructions assume that this has been done if necessary.
Configure a new repository with Portage (eselect repository will default to "git" sync-type for this):
root #eselect repository enable gentooResolving qa-reports.gentoo.org... 151.101.2.137, 151.101.66.137, 151.101.130.137, ... Connecting to qa-reports.gentoo.org|151.101.2.137|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 260904 (255K) [text/xml] Saving to: '/root/.cache/eselect-repo/repositories.xml' repositories.xml 100%[=============================================================================>] 254.79K 1.25MB/s in 0.2s 2022-08-20 09:17:36 (1.25 MB/s) - '/root/.cache/eselect-repo/repositories.xml' saved [260904/260904] Adding gentoo to /etc/portage/repos.conf/eselect-repo.conf ... Repository gentoo added
You can view more git-related(
sync-git*) options through man 5 portage.Verify the repos.conf content, including in particular the location entry in the gentoo section:
user $portageq repos_config /[DEFAULT] auto-sync = yes main-repo = gentoo strict-misc-digests = true sync-allow-hardlinks = true sync-openpgp-key-refresh = true sync-rcu = false [gentoo] auto-sync = yes location = /var/db/repos/gentoo masters = priority = -1000 strict-misc-digests = true sync-allow-hardlinks = true sync-openpgp-key-path = /usr/share/openpgp-keys/gentoo-release.asc sync-openpgp-key-refresh = true sync-openpgp-key-refresh-retry-count = 40 sync-openpgp-key-refresh-retry-delay-exp-base = 2 sync-openpgp-key-refresh-retry-delay-max = 60 sync-openpgp-key-refresh-retry-delay-mult = 4 sync-openpgp-key-refresh-retry-overall-timeout = 1200 sync-openpgp-keyserver = hkps://keys.gentoo.org sync-rcu = false sync-type = git sync-uri = https://github.com/gentoo-mirror/gentoo.git
The default location is a repository hosted on GitHub, which does not support cloning via IPv6 [1], so IPv6-only users should modify the /etc/portage/repos.conf/eselect-repo.conf file, replacing the GitHub link with
https://anongit.gentoo.org/git/repo/sync/gentoo.git. Alternatively, a DNS name server with NAT64 support can be used. To see a list of such public name servers, see this link.Delete the old repository:
root #rm -r /var/db/repos/gentooIf the old repository is in /usr/portage, remove that directory instead. Any existing distfiles (in /usr/portage/distfiles/) or binary packages (in /usr/portage/packages/) can be moved to the new locations under /var/cache/ if desired. Run eselect profile set <profile> to set the same profile noted earlier.
Sync the repository with the new Git configuration:
root #emaint sync -r gentooRun again to test.
Later emerges may be lengthy without metadata cache during dependency resolution. The cache can be rebuilt using egencache. For further reading, refer to Portage and ebuild repository synchronization.