View on
Thierry Vignaud > urpmi > urpmi.addmedia


Annotate this POD


Open  0
View/Report Bugs


urpmi.addmedia - adds a new rpm media to be used by urpmi


    urpmi.addmedia [options] <name> <url>


urpmi.addmedia is used to add a new media to be used by urpmi, so it can find new rpms at the specified location. Currently supported media types are: local drives, removable drives (such as CDs), and networked media via different protocols (http, ftp, ssh and rsync). One of the following modes must be chosen:

urpmi.addmedia [options] --distrib --mirrorlist [<url>]

A mirror list is a special API to describe mirrors available. urpmi will pick the nearest mirror, and will dynamically handle new mirrors. Example:

  urpmi.addmedia --distrib --mirrorlist
urpmi.addmedia [options] --mirrorlist <url> <name> <relative path>


  urpmi.addmedia --mirrorlist '$MIRRORLIST' backports media/main/backports
urpmi.addmedia [options] <name> http://<login>:<pass>@<host>/<path>

where <name> is a human-readable name for the new media (e.g. "updates"). <name> is optional if --distrib is given in the options list. <host>/<path> is the location of the media directory on the net (e.g. media/main). The location is given relative to <path>. curl is used by default to download files, wget may be used if curl is not installed or if or --wget is given in options. Example:

    urpmi.addmedia http
urpmi.addmedia [options] <name> ftp://<login>:<pass>@<host>/<path>

The same as for http. Add your login and password if required (note that you don't need to specify anonymous as login for anonymous access ftp servers). If wget is used to download files with a firewall you may have to ensure that the passive_ftp option is on in /etc/wgetrc (that's usually the default). Example:

    urpmi.addmedia ftp ftp://a:a@leia//export/media/main
urpmi.addmedia [options] <name> ssh://<login>@<host>/<path>

The same as for http and ftp; add your login and password if required. You may want to export the public key in order not to have to type your password. rsync over an ssh connection will be used to get files. urpmi will try to re-use the same ssh connection over multiple invocations.


    urpmi.addmedia ssh ssh://fpons@bi/c/i586/media/main
urpmi.addmedia [options] <name> rsync://<login>@<host>:<port>/<path>

The same as for http; you can use the <host>::<path> syntax too. Example:

    urpmi.addmedia rsync rsync://
urpmi.addmedia [options] <name> file://<path>

where <name> is a human-readable name for the new media (e.g. "local updates"). <path> is the location of the media directory on your machine (e.g. media/main).

urpmi.addmedia [options] <name> cdrom://<path>

<path> is the location of the media directory in the CDROM or DVD.


Media Search and Selection


Use the given url as a mirror list. It is quite special, please see examples at the beginning of this page.

You can also give a space separated list of urls. Each url can be either a mirrorlist or a mirror url. This is useful if you have a mirror to use inside a local network, but still use standard mirrors when the local mirror is not available.

nb: $MIRRORLIST is a special variable which gives the default URL for the current distribution/arch. $MIRRORLIST is the default mirrorlist.


Find a media repository for the current distribution using zeroconf (DNS-SD). It can be used together with --distrib or by specifying a media name and a path to the media directory, relative to the repository root.


Retrieve a set of media from a distribution. Typically, the URL provided to urpmi.addmedia will represent the parent directory of a directory media, which in turn will contain various subdirectories for each medium of the distribution. <name> is combined with medium names found to create newer medium names in the urpmi database.


This option is to be used with --distrib. With it, urpmi.addmedia will ask for confirmation for each media it finds for the specified distribution.


This option is to be used with --distrib. With it, urpmi.addmedia will attempt to add all media it finds. By default, it won't add media containing source rpms, or media corresponding to supplementary CD-ROMs on distributions.

Media Handling


Adds a media which will be taken into account by MageiaUpdate or by urpmi --update when looking for updates.

If used together with --distrib, it will only add media flagged "update".


Activate or deactivate rpm signature checking of newly added media. It's activated by default, and can be overridden in global configuration.


Use the specific policy for downloading xml info files. It must be one of: never, on-demand, update-only, always. See urpmi.cfg(5) for more information.


Use synthesis file.


Use rpm files (instead of synthesis).


Creates a virtual medium: the medium is always up-to-date and so it does not need to be updated by urpmi.update.


Add the new media in the urpmi configuration file, but don't update it nor proceed to any download. The media, to be usable, will need to be updated with urpmi.update; it's ignored until then.


Don't import pubkey of added media.

Download Options


Use wget only for downloading distant files. By default curl is used if available.


Use curl only for downloading distant files. This is the default if curl is available.

--curl-options 'options'
--rsync-options 'options'
--wget-options 'options'

Specify additional command-line options to be passed to curl, rsync or wget when retrieving files. If several options are to be passed, separate them with spaces and enclose them in quotes.

Note that the rsync options will also be used for ssh media.

--limit-rate rate

Try to limit the download speed, rate is given in bytes/sec. This option is not active by default.

--proxy proxyhost[:port|1080]

Use specified HTTP proxy.

--proxy-user user:password

Use specified user and password to use for proxy authentication. Specifying --proxy-user=ask will cause urpmi.addmedia to prompt for a username and a password.

Database Options

--urpmi-root directory

Use the file system tree rooted for urpmi database and rpm install. Contrary to --root, the urpmi configuration comes from the rooted tree.


If the urpmi or rpm db is busy, wait until it is available

Variables ^

Beginning with urpmi 4.6.16, you can use variables in media URLs (for example /mnt/mirror/$RELEASE/$ARCH/media/main). The variables supported so far are:


The architecture (if found in /etc/release).


The OS release (if found in /etc/release; its value should be cauldron on a Mageia cauldron system.)


The canonical hostname of the machine urpmi runs on.


The url of the default mirrorlist for the distribution.


urpmi(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), urpmq(8), urpmi.files(5).

Author ^

Pascal Rigaux <> (original author and current maintainer), François Pons, Rafael Garcia-Suarez

syntax highlighting: