Migrate existing Repositories

Using a distributed version control software system (like Git) allows you to keep control of the data inside the repository. If you want to download a local copy of your files, you can git clone your repo, or download the repo from the web interface. This works well for moving files, but not for metadata like issues, releases and the wiki. If you want to migrate those as well, you can use the migration tool.

1. Click on the ”+” symbol on the top right and select New migration in the dropdown menu.
2. On the New migration page, select the source Git host.
   • For GitHub, GitLab, GitBucket, Gitea and others, the migration tool can migrate not only your repository data, but also metadata like issues, labels, wiki, releases, milestones, etc.
   • If you cannot find your service, you can select the Git option. This will, however, not migrate mentioned metadata.
   • To migrate a repo with its metadata from a different service, you will first need to create an access token on the service with your repository. Please check the services’ documentation on how to get the access token. Examples can be found for GitLab and GitHub.
     Do not forget to delete the access token once you are finished.