mirrors.conf
This document applies only to clients using PaludisEnvironment. Any standard client that supports a
--environment command line option uses PaludisEnvironment unless overridden, either by
explicitly selecting another environment (e.g. --environment portage) or, on distributions also
supporting Portage, by lack of a Paludis configuration and presence of a Portage configuration.
The mirrors.conf file controls where Paludis looks when downloading files. It is a standard
configuration file which may be a bash file (mirrors.bash) and which may use the
mirrors.conf.d/ directory.
Each line consists of a mirror name followed by one or more URLs. The special mirror name * can be used
to indicate a mirror that should be tried for all URLs (even those that are marked as 'not for mirroring'). Ebuild
format repositories also treat mirrors whose name is equal to the repository name (or, if the repository has a
master, the master's name) specially, checking them for all mirrorable files.
Usually you do not need a mirrors.conf at all. The repository-provided defaults are in
most cases perfectly adequate. You generally only specify mirrors if your ISP has a local mirror of certain projects
that provides better download speeds than the default random selection.
Example
# Try a fast local mirror first * http://myfastbox/distfiles/ # For mirror://gentoo/, use our ISP's mirror. This mirror will be consulted # for most files in the 'gentoo' repository, and repositories using 'gentoo' # as a master, as well as for any explicit mirror://gentoo/ entry. gentoo http://gentoo.virginmedia.com/distfiles/ # Use a local Debian mirror too. This is only used for mirror://debian/. debian http://debian.virginmedia.com/