From Gentoo Wiki
< /etc‎ | portage(Redirected from Repos.conf)
Jump to:navigation Jump to:search
This page contains changes which are not marked for translation.

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.

The eselect-repository tool automatically configures /etc/portage/repos.conf.
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 /
auto-sync = yes
main-repo = gentoo
strict-misc-digests = true
sync-allow-hardlinks = true
sync-rcu = false
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
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
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:

FILE /etc/portage/repos.conf/eselect-repo.confSet priority of a repository
# created by eselect-repo
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

External resources