git-mirror - simple Git mirrors

git-mirror is designed to create and serve read-only mirrors of your Git repositories locally or wherever you choose. A recent GitHub outage reinforces the fact that developers shouldn't be relying on a single remote for hosting code.

A major design goal of git-mirror is that it should just work with as little configuration as possible.

This fork has the following additional features:

• Mirror Mercurial repositories into Git repositories via git-remote-hg
• Optionally sync between the source repositories and the mirrors hosted elsewhere, e.g., from Bitbucket to GitHub
• Optionally automatically clone repositories from origin when requested repositories don't exist

// TODO: Consider switching to: https://github.com/cosmin/git-hg

Get started

Download and compile the source code.

If you want to mirror Mercurial repositories, you also need to set up git-remote-hg according to its instruction.

Create config.toml similar to:

[[repo]]
Origin = "https://github.com/NexZhu/git-mirror.git"
Target = "[email protected]:NexMirror/git-mirror.git"

By default it will update the mirror every 15 minutes and will serve the mirror over HTTP using port 8080. You can specify as many repos as you want by having multiple [[repo]] sections.

Run git-mirror with the path to the config file:

$ ./git-mirror config.toml
2015/05/07 11:08:06 starting web server on :8080
2015/05/07 11:08:06 updating github.com/beefsack/git-mirror.git
2015/05/07 11:08:08 updated github.com/beefsack/git-mirror.git

Now you can clone from your mirror on the default port of 8080:

$ git clone http://localhost:8080/github.com/beefsack/git-mirror.git
Cloning into 'git-mirror'...
Checking connectivity... done.

Advanced configuration

See the example config for more advanced configurations.

Authentication and authorisation

If you wish to control access to the mirror or specific repositories, consider proxying to git-mirror using a web server such as Nginx.