Importing or mirroring a repository in SourceCraft

You can import or mirror into SourceCraft your source code repository hosted in another IT project management system for Git.

Mirroring allows you to automatically synchronize particular branches between the source repository and the SourceCraft repository.

Within a repository, you can import the following:

• Commit history
• All existing branches
• Open and closed pull requests
• Issues
• Comments
• Tags

To import or mirror a repository in SourceCraft:

1. Open the SourceCraft home page.

2. In the left-hand panel, click Create repository.

3. In the window that opens, go to the Migrate existing tab.

4. Under Your source repository details:

   • In the URL field, specify the link to the repository hosted in another IT project management system.
   • Select the authentication method in the source repository:
     • Personal access token: If using a personal access token (PAT) to access the repository. For GitHub-specific details, see Managing your personal access tokens.
     • Username and password: If using a username and password to access the repository.
   • Enter the authentication data depending on the selected method.

5. Under Your new repository details:

   • In the Name field, specify a name for the repository you want to create in SourceCraft. The name may contain the following ASCII characters: lowercase and uppercase Latin letters, numbers, commas, hyphens, and underscores.
   • In the Visibility field, select the repository access type:
     • Private: Only users invited by you will have access the repository.
     • Public: All users will have access to the repository.

6. Optionally, if you want to mirror a repository, enable synchronization under Synchronization and specify the branches you want to automatically update from the source repository. You can use templates, for example, main, feature/*, or release/*.

   The mirrored SourceCraft repository branches are subject to branch policy protection rules. You cannot change them in SourceCraft; they get updated only when syncing with the source repository.

   If the branch policy is disabled or overridden by a user with the Repository admin role, the SourceCraft commit history will be overwritten (force push) during the next repository sync.

7. SourceCraft will automatically check access to the source repository and whether or not SourceCraft can create a repository with the name you specified.

   If all checks are successful, you will see this message: Everything's ready to migrate. Fasten your seat belts and let's take off!.

   Click Begin migration.

This will open the window with a list of your repositories in SourceCraft. Next to the repository you are importing, you will see the migration status. Click the status to view the details.

Once the migration is complete, you will be able to work with the migrated repository in SourceCraft.

See also

• Getting started with SourceCraft