Importing a repository to SourceCraft
You can migrate your source code repository hosted in another dedicated git project management system to SourceCraft.
Note
Currently, you can only import repositories hosted on GitHub.
Importing repositories connected to Git Large File Storage (LFS) is not supported.
Within a repository, you can migrate the following:
-
Commit history
-
All existing branches
-
Tags
To migrate a repository to SourceCraft:
-
Open the SourceCraft home page.
-
In the left-hand panel, click Create repository.
-
In the window that opens, select Migrate existing repository.
-
Under Your source repository details:
- In the URL field, provide the link to the repository you want to migrate.
- Select the authentication method for the repository being imported:
- 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.
-
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.
-
SourceCraft will automatically check access to the repository being imported as well as whether 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.