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

• Asia:

  • Singapore : Maintainer: Tully Foote <tfoote AT osrfoundation DOT org>

  • Tokyo, Japan : Maintainer: TORK <sysadmin AT opensource-robotics DOT tokyo DOT jp>

  • China : Maintainer: Autolabor <autolabor4u AT gmail DOT com>

  • China : Maintainer: ExBot Robotics Lab <poyoten AT 163 DOT com>

  • Ho Chi Minh, Viet Nam : Maintainer: VinaHost <tienhn AT vinahost DOT vn>

• Europe:

  • Freiburg, Germany : Maintainer: Henrich Kolkhorst <kolkhorst AT cs DOT uni-freiburg DOT de>), Jannik Zürn <zuern AT cs DOT uni-freiburg DOT de>

  • Barcelona, Catalonia : Maintainer: labrobotica <labrobotica AT iri DOT upc DOT edu>

• North America:

  • College Park, Maryland : Maintainer: Moshe Katz <mirror AT mirror DOT umd DOT edu>

  • Saint Louis, Massachusetts : Maintainer: Boris <contact AT namesdir DOT com>

  • Potsdam, New York : Maintainer: Hunter Bashaw <bashawhm AT clarkson DOT edu>

  • Los Angeles, California : Maintainer: Mike R. miker AT ghostarchive DOT org (Ghostarchive)

• South America:

  • São Paulo, Brazil : Maintainer: Murilo F. M. <murilo.fm AT fei DOT edu DOT br> (Centro Universitário da FEI)

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 discourse.ros.org: http://discourse.ros.org/c/mirrors for both feedback and prompt updates.

All in 1 Mirror

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

https://github.com/ros-infrastructure/mirror

Mirroring the wiki

This makes the assumption you're running a webserver in /var/www/wiki.ros.org.

Setup rsync

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

#!/bin/bash
echo Downloading Wiki-Dump
rsync -azv rsync.osuosl.org::ros_wiki_mirror /var/www/wiki.ros.org --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/www.ros.org>
                   # ...
    -              AllowOverride None
    +              AllowOverride FileInfo
                   # ...
          </Directory>

• Nginx needs the following configuration:

  location ~* ^/roswiki/.+\.timestamp$ {
      add_header Access-Control-Allow-Origin "http://wiki.ros.org";
  }

Mirroring docs.ros.org

This makes the assumption you're running a webserver in /var/www/docs.ros.org

#!/bin/bash
echo Downloading API-Dump
rsync -azv rsync.osuosl.org::ros_docs_mirror /var/www/docs.ros.org --bwlimit=200 --copy-unsafe-links --delete

• If you need only certain ROS distro and exclude others, say kinetic, you could download by:

      $ rsync -azv rsync.osuosl.org::ros_docs_mirror/kinetic /var/www/docs.ros.org --bwlimit=200 --copy-unsafe-links --delete

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

Mirroring packages.ros.org mirror

To create a mirror of packages.ros.org 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 answers.ros.org.