Atlassian Bitbucket Atlassian Stash How To

How to mirror Bitbucket Cloud and GitHub repositories to Bitbucket Server (Stash)

Visualize, track and analyze repositories hosted in Bitbucket with Awesome Graphs. Benefit from what graphs, charts and reports can tell you. Learn more


When working on our add-ons, we at StiltSoft are using Bitbucket Server (Stash) for distributed version control management and code collaboration. Some of you have also picked Bitbucket Server, others went with another solution, e.g. Bitbucket Cloud, GitHub, or are using several platforms at once. Whatever tool you work in, mirroring repositories can come in useful in certain cases. That is why last month we posted the article that covered the benefits and how-tos about mirroring remote repositories from Bitbucket Server (Stash). Meanwhile, creating mirrors in Bitbucket Server rather than mirroring from it might be more relevant for some of our blog readers, so today’s post is about that.


There’s a number of goals which can be attained by mirroring repositories from Bitbucket Cloud or GitHub to Bitbucket Server (Stash). Among them:

  • protecting yourself from down time when Bitbucket Cloud or GitHub are unavailable
  • consolidating repositories in one place
  • facilitating the process of migration from Bitbucket Cloud or GitHub to Bitbucker Server

How to mirror Bitbucket Cloud repositories

To arrange automatic update of mirrored repositories you can:

  • Use an add-on for Bitbucket Server
  • Use a Continuous Integration tool
  • Use an OS job scheduler

In our examples, we’ll be mirroring a Bitbucket Cloud repository to Bitbucket Server.

Use an add-on for Bitbucket Server

ScriptRunner for Bitbucket Server/Stash can come in handy when you are looking to mirror some or all of your Bitbucket Cloud repositories to Bitbucket Server.

It’s very simple.

  • Once the add-on is installed, navigate to Bitbucket Server Administration and select Built-in Scripts in the Script Runner Section.
  • There, choose Mirror Bitbucket Team. You can mirror repositories both from team and user Bitbucket Cloud accounts.


  • Enter your Bitbucket Cloud Team or User, select the target project in Bitbucket Server, provide your Bitbucket Cloud user credentials.

ScriptRunner-Mirror Bitbucket Team

  • Select one of the synchronization options (none, install hook or poll). If you choose:
    • ‘install hook’, Bitbucket Cloud will call your Bitbucket Server instance when there are changes in repositories which will trigger synchronization
    • ‘poll’, each remote repository will be polled every 5 minutes
    • ‘none’, there will be no synchronization performed
  • In the Regex field, there is the ‘.*’ regular expression by default. If you leave it as it is, all repositories will be mirrored from your Bitbucket Cloud. To filter the set of repositories, insert a corresponding regular expression. The regular expression is done against the repository name, e.g. for the repository ‘StiltSoft Test’ you could use:
  • Another useful feature. If you’d like new Bitbucket Server repositories to be created and synchronized when there are newly-added remote repositories in Bitbucket Cloud, mark the ‘Sync new’ checkbox.
  • When all set, click Run. You’ll see the table with the repositories that are being mirrored. Initially there’s the ‘Create’ label. When the process is completed, it will say ‘Exists’ instead. You may tail the application log file to track the progress.

ScriptRunner-Mirror Bitbucket Team-2

  • Once local repositories are created, you can refer to the Configure Mirrored Repositories in Built-in Scripts to view and check the status of your mirrored repositories and change the synchronization type.

ScriptRunner-Configure mirrored repos

Use a Continuous Integration tool

If you have some Continuous Integration solution, e.g. TeamCity, in your arsenal, you can use it. Here is one of the options how to set up automatic update of mirrors in Bitbucket Server using TeamCity.

  • To use SSH-authentication, copy a SSH key from the TeamCity server with a build agent you’ll be using. Then add this SSH key in your Bitbucket Cloud and Bitbucket Server account settings.
  • Then you need to create a repository in Bitbucket Server
  • After that, create a local copy of source repository on build agent (don’t forget to add Bitbucket Server repository as remote):
cd /home
mkdir mirror
cd mirror
git clone
cd demonstration-repository
git remote add bitbucket ssh://

Now you should make some changes in build configuration in TeamCity:

  • Add a Command Line Runner build step with a script for updating mirrored repositories that will run every time this build step is invoked.

TC Build Step

Example of the script, e.g.:

cd /home/mirror/demonstration-repository
git pull
git push --all bitbucket
git push --tags bitbucket

You may also add a VCS Trigger that will add a build to the queue when a VCS check-in is detected in the repository you are mirroring.

  • Before adding a trigger, you should attach a VSC root in the Version Control Settings:


With the URL of the original repository and Bitbucket Cloud authentication settings:

TC VCS Root-details

  • Now you can add a VCS Trigger:

TC VCS Trigger

Use an OS job scheduler

You can also use OS job schedulers (Cron, Windows Task Scheduler) and configure an external job and schedule the launch of scripts that will be pulling changes and pushing them to a mirrored repository.

  • First we clone a repository:
cd /home/mirror
git clone
cd demonstration-repository
git remote add bitbucket ssh://
  • If you use Cron, you’ll need to add a command in your crontab file that will run periodically on a given schedule and will be updating mirrored repositories, e.g.:
0  0    * * *   root    /home/mirror/

This command will run from the user ‘root’ every day at midnight and trigger a script that has a number of commands to perform update of mirrored repositories.

For the case when you have one mirrored repository that should be updated, the content of ‘’ will look like this:

cd /home/mirror/demonstration-repository
git pull
git push --all bitbucket
git push --tags bitbucket

If you need to mirror more than one repository, include 4 commands you can see above for each repository in ‘’.

Recommended Articles