/etc/portage/repos.conf
The Gentoo ebuild repository and additional repositories configuration files are in the /etc/portage/repos.conf directory, which specifies current Portage configured repositories' location and settings.
Creating it manually is not recommended by the handbook anymore. It changes /usr/share/portage/config/repos.conf defaults.
Necessary repos.conf settings, such as the sync-uri value, can be changed. Portage automatically adds some missing configuration file values, such as priority.
man 5 portage, section /etc/portage/repos.conf details repos.conf parameters and format information.
Manage repositories
Add, disable, or remove ebuild repositories using eselect repository, which also provides other functionality.
It is also possible to add a repository by manually creating files in /etc/portage/repos.conf, see the appropriate section of the Handbook (other reference).
Files in /etc/portage/repos.conf can be edited with a text editor to change the configuration options for an ebuild repository.
List repositories
To show all repositories configured with portage, run portageq:
user $portageq repos_config /[DEFAULT] auto-sync = yes main-repo = gentoo strict-misc-digests = true sync-allow-hardlinks = true sync-rcu = false [brother-overlay] auto-sync = yes location = /var/db/repos/brother-overlay masters = gentoo strict-misc-digests = true sync-allow-hardlinks = true sync-rcu = false sync-type = git sync-uri = https://github.com/gentoo-mirror/brother-overlay.git [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-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 = rsync sync-uri = rsync://rsync.gentoo.org/gentoo-portage sync-rsync-verify-max-age = 24 sync-rsync-extra-opts = sync-rsync-verify-jobs = 1 sync-rsync-verify-metamanifest = yes [local] auto-sync = no location = /var/db/repos/local masters = gentoo strict-misc-digests = true sync-allow-hardlinks = true sync-rcu = false
Ebuild repository priority
To set the priority of a certain repository, manually edit the relevant repos.conf section and set priority = to the desired value. The higher the set value, the higher the priority. For example:
/etc/portage/repos.conf/eselect-repo.confSet priority of a repository# created by eselect-repo
[guru]
location = /var/db/repos/guru
sync-type = git
sync-uri = https://github.com/gentoo-mirror/guru.git
priority = 100
Repositories that do not have a priority explicitly set, default to 0 - except the Gentoo ebuild repository, which defaults to to a value of -1000.
Alternative sync protocols
See the Portage with Git article for how to sync the ::gentoo ebuild repository using git as an alternative to the traditional rsync protocol.
See also
- Project:Portage/Repository_Verification — describes different methods used to ensure authenticity of the Gentoo ebuild repository.
- Overview of the Portage sync system
- Overlays user guide
- Repository format — A quick reference to Gentoo ebuild repository (overlay) format.
- Repository mirror and Continuous Integration
- Query repository information in the Portageq article
- Using the gentoo git checkout as your local tree
- Masking enabled ebuild repositories
- eselect repository — an eselect module for configuring ebuild repositories for Portage.
- Portage Security — aims to answer the question "How can I dispel doubts regarding the security of the Gentoo ebuild repository on a system?"
- /etc/portage/binrepos.conf — specifies the location and settings for binary package repositories configured with Portage.