Page History

This is a step-by-step guide to importing and mirroring a Subversion project into a Git repository.

1. In Bitbucket Server, create a project by clicking Create Project or select the existing one.
   Image RemovedImage Added
   
   
2. Add an empty Git repository to your project by clicking Create Repository.
   Image RemovedRepository or select the existing repository.
   Image Added
   
   
3. To specify the settings for the initial configuration of a Subversion project:
   
   
   1. On an empty repository page, click SVN Mirror.
      Image Added
      
      
   2. In the existing non-empty repository, click Repository Settings, and then click SVN Mirror
   to specify the settings for the initial configuration of
   1. in the sidebar menu.
      Image Added
      
      

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

   Image Removed
   Specify the following details:
   URL to a Subversion project

   Note
   Each Subversion project is translated to a separate Git repository.

5. Specify credentials to log in to a Subversion repository that contains the required Subversion projectselect project.
   Image Added
6. Select the way to identify a Subversion project layout (the trunk, branches, tags and shelves), and shelves):
   Image Added
   
   • To specify manually the rules to map the Subversion directories to Git references at the next step, select Manual Configuration.
   • To import or mirror the whole Subversion directory, which the URL points to, into a single Git master branch, select Single Directory Translation.

   • To allow SVN Mirror to identify branches and tags automatically relative to the trunk folder, select Automatic Configuration. To specify the trunk folder, click Select Trunk Path… , and then select the trunk folder.

     Note
     The automatic layout identification may take some time in case your Subversion project has a large branch history.

     Based on the option that you’ve selected, SVM Mirror generates the branch mapping rules and displays them on the Branches Mapping tab. You can adjust these rules to map the required Subversion directories correctly.

     
     

7. In the Email Domain filed, specify the email domain for automatic authors mappingthe automatic Git author generation.
   
   
8. To start the initial configuration of the project, click Continue. 
   To reset the initial configuration settings that you’ve specified, click Reset to Defaults.
   
   
9. After the initial configuration, reviewReview, and if required, adjust the configuration settings to import or mirror your Subversion project properly. See the Specifying import Import and mirror configuration settings section for the detailed information.
   To reset restore previous configuration setting that you’ve specified, click  Revert Changes.
   To go back to the initial configuration of a Subversion project, click Back.
   
   

10. To perform import of To import a Subversion project repository into a Git repository, click Import.

    After import, the synchronization between the Git and the Subversion repositories is disabled.

    Tip
    To You can start synchronizing the Git repository with , which contains the imported Subversion project and , with the corresponding original Subversion repository at any time. To do this, click Enable on the Mirror Status pane.

    Image Modified

11. To mirror a Subversion project into a Git repository, click Mirror. 

    The Git repository with with the imported  imported Subversion project keeps stays synchronized with the corresponding original Subversion repository. The changes committed either to Subversion or Git repositories are synchronized in both directions.

    Note
    In case you import or mirror into the non-empty Git repository, the commits that have already existed in this repository become unsynced. After import, resolve conflicts manually on the Unsynced Commits tab.

    
    

    Info
    Importing and mirroring may take significant time. It depends on the size of your Subversion project.