SVN Mirror Add-on

Space shortcuts

Page tree

Import and mirror configuration settings enable SVM Mirror to translate your Subversion project to Git in a proper way. The configuration settings include:

Specify them on the corresponding tabs on the "Review Configuration and Start Mirror or Import" page.

Branch mapping settings

On the Branches Mapping tab, view, and if required, adjust the rules to map Subversion directories (such as the trunk, branches, tags, and shelves) to Git references.

Use the following mapping format:

<Subversion-Path-Pattern>:<Git-Reference-Pattern>

Paths to Subversion directories are defined relative to the URL specified in the URL field on the Connection tab.

Adjust the default mapping rules to make them correspond to your Subversion project layout or in case you want to map only particular Subversion directories, but not all of them.

The default mapping rules:

trunk = trunk:refs/heads/master
branches = branches/*:refs/heads/*
tags = tags/*:refs/tags/*
shelves = shelves/*:refs/shelves/*

Translation settings

On the Translation Settings tab, specify the following settings:

  • In the Minimal Revision field, specify the Subversion revision number, from which you want to start translating history of changes to Git.
  • To translate the changes of the svn:eol-style and svn:mime-type Subversion properties to the .gitattributes files, select the Translate file attributes checkbox.
  • To translate the changes of the svn:ignore Subversion property to the.gitignore files, select the Translate Ignores checkbox. By default, this option is selected.

These settings are used only once (during the first synchronization) and cannot be changed after the Subversion project has been imported or mirrored.

Author mapping settings

On the Translations Settings tab, select the options for mapping Subversion usernames (svnUser) to Git authors (Author Name <email>).


  • To use the mapping rules specified for the current Git repository on the Authors Mapping tab, select the Use Repository Authors Mapping checkbox.
  • To use Bitbucket users registry to search for matches between Subversion usernames and Git authors, select the Map Subversion Users to Bitbucket Users checkbox.
  • To use the mapping rules specified on the Global Authors Mapping tab, select the Use Global Authors Mapping checkbox. See the Specifying global author mapping rules section for the detailed information.

You may use all options or any combination of them. By default, all three options are selected.

SVN Mirror refers to the mapping rules in the following sequence. If the mapping option is not selected or the match is not found, SVM Mirror refers to the next selected mapping option:

  1. mapping rules for the current Git repository
  2. BitBucket user registry
  3. global authors mapping rules.

If no match is found for a Subversion username, SVN Mirror automatically generates the Git author using the email domain specified in the Email Domain field.

The following format is used for the automatic author generation:

svnUser = svnUser <svnUser@example.com>

Specifying author mapping rules for the current Git repository

On the Authors Mapping tab, specify the rules to map Subversion users (svnUser) to Git authors (Author Name <email>) and vice versa.

These mapping rules are applied only to the current Git repository.

Make sure that the Use Repository Authors Mapping checkbox is selected. By default, this checkbox is selected.

Use the following mapping format:

svnUser = Git User <user@example.com>

Subversion connection settings

On the Connection tab, specify or change the URL to a Subversion directory and the authentication settings to log in to a Subversion repository.


In the URL field, specify the URL to a Subversion project that you want to import or mirror.

Each Subversion project is translated to a separate Git repository.

Then, specify or change the authentication settings to log in to a Subversion repository.

To use the authentication data from a Subversion server and credentials cache, select the Use server-side Subversion configuration and credentials cache checkbox. The configuration directory path is displayed under the checkbox.

Otherwise, clear the checkbox and select the authentication method to log in to a Subversion repository from the Authenticate With list. Depending on the configuration of your Subversion server, you may select:

  • Username and Password
  • SSH Private Key
  • SSL Client Certificate

Specify the required credentials for the authentication method that you’ve selected.

Check connection to the Subversion repository by clicking Test Connection.

Synchronizing with a Subversion repository


In the Poll Interval field, specify (in seconds) how often SVN Mirror will pull the changes from the original Subversion repository.

The default polling interval is 60.

To disable periodic synchronization and synchronize when pushing commits to a Git repository, set the polling interval to 0 (zero).

In case you have a lot of mirrors, the default polling interval may cause performance issues.

To reduce SVN Mirror resource usage, we recommend you to use REST API to invoke the explicit synchronization or to install the post-commit hook script on a Subversion server to call REST API. For more information, see SVN Mirror for Bitbucket server REST API.

  • No labels