Skip to main content

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.

Source Distribution

vcs_mirrors-0.0.7.tar.gz (10.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page