Skip to main content

Repository Mirror

It is often desirable to mirror repositories between OneDev and other hosting services. For instance you may want to push changes to a copy at GitHub for public access, or want to pull back any changes contributed by others at GitHub.

OneDev 7.1 made this task trivial with the new repository sync steps. Let’s see how to achieve this.


First of all, start OneDev by running below command:

$ docker run -t --rm -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd)/onedev:/opt/onedev -p 6610:6610 -p 6611:6611 1dev/server

Point your browser to localhost:6610 to setup OneDev, and create a test project.

Then create an empty repository at GitHub side to be used as mirror of our test repository, assume the url is:

Push Changes to Mirror

Now we configure OneDev to push changes to GitHub mirror as long as there is a change in branch or tag:

  1. Login to your GitHub account and generate a personal access token able to push to the mirror repository

  2. At OneDev side, create a job secret in the test project and use access token above as its value:

  3. Define build spec to add a job say Push to GitHub, and add a step of type Repository Sync / Push to Remote. For password / access token field, choose the job token defined above:

  4. Add triggers to run job automatically when branch is updated or tag is created:

Now save the build spec and the job will run automatically to push changes to GitHub mirror. Check at GitHub side, and you will see it contains newly created file .onedev-buildspec.yml. Experiment with other changes such as creating new branch/tag to see the result.

Pull Changes from Mirror

Our GitHub mirror may accept pull requests from contributors, so let’s set up OneDev to pull changes from it:

  1. Continue to edit build spec above, add a job say Pull from GitHub, and add a step of type Repository Sync / Pull from Remote like below:

    Here we use the same job token defined above to access GitHub mirror (access token can be left empty if the mirror is publicly accessible).

  2. Add a job trigger of cron type to run job on scheduled time, for instance, on 1:00AM every night:

  3. If your OneDev instance can be accessed publicly, you can configure GitHub to trigger this pull job upon mirror changes. This can be done by creating a webhook at GitHub side like below:

    The payload url is defined as:<OneDev access token>

    Here is dns name accessing your OneDev instance. Job name is url encoded as it contains space. <OneDev access token> should be replaced by access token of a OneDev user with permission to run the job like below:

    For production use, it is important to enable https protocol for payload url to avoid leaking of access token.

    Save the webhook and OneDev should be pulling from GitHub mirror whenever it is changed.


We’ve completed setup of a two-way sync of OneDev repository and its GitHub mirror. Since it is just an ordinary CI job, we can subscribe certain build query to be notified of sync failures, check build log to investigate sync failures, or even configure job resource setting to control resource usage of multiple sync jobs, etc.

Thanks for reading!