debian-mirror-gitlab/doc/workflow/importing/import_projects_from_github.md
2016-01-19 16:12:03 +05:30

1.8 KiB

Import your project from GitHub to GitLab

Note: In order to enable the GitHub import setting, you should first enable the GitHub integration in your GitLab instance.

At its current state, GitHub importer can import:

  • the repository description
  • the git repository data
  • the issues
  • the pull requests
  • the wiki pages

The importer page is visible when you create a new project. Click on the GitHub link and you will be redirected to GitHub for permission to access your projects. After accepting, you'll be automatically redirected to the importer.

New project page on GitLab


While at the GitHub importer page, you can see the import statuses of your GitHub projects. Those that are being imported will show a started status, those already imported will be green, whereas those that are not yet imported have an Import button on the right side of the table. If you want, you can import all your GitHub projects in one go by hitting Import all projects in the upper left corner.

GitHub importer page


The importer will create any new namespaces if they don't exist or in the case the namespace is taken, the project will be imported on the user's namespace.

Note

When you import your projects from GitHub, it is not possible to keep your labels, milestones, and cross-repository pull requests. We are working on improving this in the near future.