This document is a WORK IN PROGRESS.
This is just a quick personal cheat sheet: treat its contents with caution!
An overlay is an ebuild repository, i.e. a repository containing packages you might want to install
and use. With Portage, the main Gentoo overlay is installed by default (you can find the config
file of this overlay here:
By default, the overlays configuration files is located here:
But alternative overlays also exist and can be used:
They are registered repositories, which are "known and more trusted" by the community. You can find them here:
They are unregistered repositories, which are not officially listed by the Gentoo Overlays project members. Note that if you want to add an overlay to the registered ones, you can follow this guide.
Table of contents¶
eselect-repository is an
eselect module for manipulating
/etc/portage/repos.conf entries (i.e. ebuild repositories/overlays).
This utility supersedes
layman for listing, configuring, and handling synchronization of
alternate repositories (except for version control systems which the package manager does not
natively sync, e.g.
g-sorcery in Portage).
List available repositories (note that added/enabled repositories are marked with
*, and that the ones installed without
eselect-repositoryare marked with
Add/enable a registered repository:
Sync added repository
Example installing monero:
Add/enable an unregistered repository:
Disable a registered repository without removing its contents:
Disable an unregistered repository without removing its contents:
Disable a registered repository and remove its contents:
Disable an unregistered repository and remove its contents:
Create a new local repository (the
createsub-command will make an ebuild repository skeleton):
If you want to search across all registered overlays (and not only the installed ones) you can
eix with the
-R option, see
Note that you can also this web interface to do so: https://gpo.zugaina.org/.
TODO (see https://wiki.gentoo.org/wiki/Layman)
If this cheat sheet has been useful to you, then please consider leaving a star here.