Wiki Mirrors

Mirrors of the ROS wiki act as a backup when the main site is unavailable, and may provide faster access to users who are geographically closer to the mirror. Current mirrors:

Query status of all mirrors

Debian Repository Mirrors

You will find Debian repository mirrors here: ROS/Installation/UbuntuMirrors

Creating a mirror

If you are maintaining a mirror please join the Mirrors category on for both feedback and prompt updates.

All in 1 Mirror

If you want to setup a machine to mirror the wiki, docs, and follow these instructions to use puppet to setup your server.

Mirroring the wiki

This makes the assumption you're running a webserver in /var/www/

Setup rsync

To create a mirror of the wiki. We have setup rsync servers for and

echo Downloading Wiki-Dump
rsync -azv /var/www/ --bwlimit=200 --delete

Make timestamp available to the ros wiki

Make sure that your webserver supports sending the Access-Control-Allow-Origin header for the wikidump.timestamp file.

  • Apache must have the headers module enabled and the for directory AllowOverride FileInfo set.

    • On Ubuntu these settings may be done by running:
      $ sudo a2enmod headers
      Edit your web server config file, like this:
            <Directory /var/www/>
                     # ...
      -              AllowOverride None
      +              AllowOverride FileInfo
                     # ...
  • Nginx needs the following configuration:
    location ~* ^/roswiki/.+\.timestamp$ {
        add_header Access-Control-Allow-Origin "";


This makes the assumption you're running a webserver in /var/www/

echo Downloading API-Dump
rsync -azv /var/www/ --bwlimit=200 --copy-unsafe-links --delete
  • If you need only certain ROS distro and exclude others, say kinetic, you could download by:

        $ rsync -azv /var/www/ --bwlimit=200 --copy-unsafe-links --delete

It's recommended to put these jobs into a cron job. Probably once a day is adequate.

Mirroring mirror

To create a mirror of it is recommended to use apt-mirror. There are many guides online how to setup an apt mirror. Such as this one from howtoforge. There's a ROS specific answer on

Wiki: Mirrors (last edited 2022-01-29 01:00:05 by TullyFoote)