Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

No project description provided

Project description


A python-only clone of with a YAML config file.



  • Mirror different types of source repositories: Bazaar, Git, Subversion. Mirror all into git.
  • GitLab mirror adding.
    • When adding a mirror if the project doesn’t exist in GitLab it will be auto-created.
    • Set project creation defaults (e.g. issues enabled, wiki enabled, etc.)
  • Github mirror adding.
    • Same as with Gitlab.
  • mirror anything to Git (not just Gitlab and Github).
  • Update a single mirror.
  • Update all known mirrors.


On Debian

For Bazaar support:

$ apt install git-remote-bzr

Install into a virtualenv:

$ virtualenv -p /usr/bin/python3 --no-site-packages venv
$ venv/bin/pip install "vcs-mirrors[gitlab,github]"

Then copy vcs-mirrors.yaml.example into your current-working-directory:

$ cp venv/lib/python3.6/site-packages/vcs-mirrors/vcs-mirrors.yaml.sample vcs-mirrors.yaml

Edit it for your needs.


venv/bin/vcs-mirrors -h
venv/bin/vcs-mirrors add -h

add examples:

This one try to create a repo “pcdummy/proxmox-dockerfiles” on - the identifier must be unique in the config file:

$ vcs-mirrors add me/p-dockerfiles

This doesn’t:

$ vcs-mirrors add me/p-dockerfiles

Full mirroring include “prune” and “force” pull/push:

$ vcs-mirrors add -f -p me/p-dockerfiles

If you give an host as target “add” creates the repo on the host and translates it to a git URL else add does nothing else than adding the params to your configuration file.


$ pip install -e ."[development,gitlab,github]"


gitlab github sync mirror vcs-mirror bazaar


This document describes changes between each past release.

0.0.7 (2018-04-23)

  • Fix pip install by moving away of PEP 420 Namespaces. [pcdummy]

0.0.6 (2018-04-23)

  • Fix another typo in [pcdummy]

0.0.5 (2018-04-23)

  • Include python files in the pip packages, part2. [pcdummy]

0.0.4 (2018-04-23)

  • Include python files in the pip packages. [pcdummy]

0.0.3 (2018-04-22)

  • Add another debug line (to show CWD changes). [pcdummy]
  • Add tag pushes. [pcdummy]
  • Make mirroring finaly working by using “–mirror”. [pcdummy]

0.0.2 (2018-04-21)

  • Fixup classifiers. [pcdummy]

0.0.1 (2018-04-21)

  • Initial Release. [pcdummy]


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 vcs-mirrors, version 0.0.7
Filename, size File type Python version Upload date Hashes
Filename, size vcs_mirrors-0.0.7.tar.gz (10.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page