Skip to main content

Mirror for open source mirror site to sync files

Project description


Build Status Python version Release version PyPi version AUR version

Mirror is an open source python application for mirror site (e.g. to sync files from upstreams (it uses rsync internally), it actually works like a cron, but still has some differences. It has been served for with more than 40 rsync tasks.

You are welcome to send comments, patches and any others to github or to @idealities.



  • Shang Yuanchun
  • Bob Gao

For contributors and past developers see: AUTHORS

Installation Instructions

Install from PyPI

You can install mirror by running pip:

$ sudo pip install mirror

Install from source

Or if you want to build and install from source:

$ python build
$ sudo python install

Config and running

After that, you are going to set up environment, you are encouraged to add a specific user to run mirrord, here we suppose the username is mirror and its home directory is /home/mirror.

Make necessary directories:

$ sudo chown mirror:mirror /var/log/mirrord /var/log/rsync
$ sudo mkdir /etc/mirror
$ sudo cp config/mirror.ini /etc/mirror/

Now you can edit mirror.ini to fit your needs and run:

$ mirrord

and that's done. Also you can use man mirrord or mirrord -h to read the documents.

If mirrord is running, you can run:

$ mirrord -t

to show the current task queue.





  • It's simple and easy to add a mirror
  • You can set a priorty for each mirror, from 1 to 10, 1 is highest
  • And scheduler will schedule a task depending on current conditions
  • You can also set a timeout for each mirror
  • Support for two stage syncing (for ubuntu, debian)
  • You can also use it as another cron...

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mirror, version 0.8.1
Filename, size File type Python version Upload date Hashes
Filename, size mirror-0.8.1-py2.py3-none-any.whl (107.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size mirror-0.8.1.tar.gz (83.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page