Paludis Logo Introduction Hooks environment.conf sets/
Bugs, Requests, Support Syncers keywords.conf / platforms.conf repositories/
Overview Fetchers use.conf / options.conf  
FAQ Env Vars licenses.conf / licences.conf  
Clients File Formats mirrors.conf  
Configuration Dep Specs package_mask.conf  
API specpath.conf bashrc  

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.

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/