Paludis Logo Introduction Hooks general.conf bashrc
Bugs, Requests, Support Syncers keywords.conf / platforms.conf suggestions.conf
Overview Fetchers use.conf / options.conf sets/
FAQ Env Vars licenses.conf / licences.conf repositories/
Clients File Formats mirrors.conf  
Configuration Dep Specs output.conf  
API specpath.conf package_mask.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.


# 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.

# Use a local Debian mirror too. This is only used for mirror://debian/.