Skip to content

Repository Mirror

This function allows for the mirroring of repositories to and from external sources. You can use it to mirror branches, tags, and commits between repositories. The following are some possible use cases for repository mirroring:

  • You migrated to STACKIT Git but still need to keep your project in another source.
    In that case, you can simply set it up to mirror to STACKIT Git (pull) and all the essential history of commits, tags, and branches are available in your STACKIT Git instance.
  • You have old projects in another source that you don’t use actively anymore, but don’t want to remove for archiving purposes.
    In that case, you can create a push mirror so that your active STACKIT Git repository can push its changes to the old location.

For an existing remote repository, you can set up pull mirroring as follows:

  1. Select New migration in the Create… menu on the top right.
  2. Select the remote repository service.
  3. Enter a repository URL.
  4. If the repository needs authentication, fill in your authentication information.
  5. Check the box This repository will be a mirror.
  6. Select Migrate repository to save the configuration.

The repository now gets mirrored periodically from the remote repository. You can force a sync by selecting Synchronize Now in the repository settings.

For an existing repository, you can set up push mirroring as follows:

  1. In your repository, go to Settings > Repository, and then the Mirror Settings section.
  2. Enter a repository URL.
  3. If the repository needs authentication, expand the Authorization section and fill in your authentication information. Note that the requested password can also be your access token.
  4. Select Add Push Mirror to save the configuration.

The repository now gets mirrored periodically to the remote repository. You can force a sync by selecting Synchronize Now. In case of an error a message is displayed to help you resolve it.