@@ -48,12 +48,21 @@ After the migration, the issues and project will be created on the new instance,
## Migrating from GitHub to GitLab
If you are migrating to a self-managed GitLab instance, you can use the GitHub import rake task detailed [here](https://docs.gitlab.com/ee/administration/raketasks/github_import.html). As in other migrations, you must have user accounts created with the same email that they have on the source GitHub instance.
### GitHab Enterprise Migrations
### GitHub Enterprise Migrations
To migrate from GitLab Enterprise, you must enable GitHub integration, found [here](https://docs.gitlab.com/ee/integration/github.html).
### GitHub.com Migrations
To import projects, you can use the import [API](https://docs.gitlab.com/ee/api/import.html). Groups must be created if they do not already exist.
Create a [Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token). This will be used to authenticate with your GitHub instance.
Similar to other project imports, follow this process after creating and saving your access token:
1. On the target instance, select New Project.
2. Select Github.com
3. Provide your personal access token.
4. Fill in the details for the project.
5. The project will be imported after a few minutes.
## Migrating from BitBucket to GitLab
Migrating from BitBucket is a straightforward process.