Project import/export
Existing projects running on any GitLab instance or GitLab.com can be exported with all its related data and be moved into a new GitLab instance.
Note:
- This feature was introduced in GitLab 8.9
- Importing will not be possible if the import instance version is lower than that of the exporter.
Exported contents
- The following items will be exported:
- Project and wiki repositories
- Project uploads
- Project configuration including web hooks and services
- Issues with comments, merge requests with diffs and comments, labels, milestones, snippets, and other project entities
- The following items will NOT be exported:
- Build traces and artifacts
- LFS objects
Exporting a project and its data
-
Go to the project settings page and find the Export button
-
Once the export is generated, you should receive an e-mail with a link to download the file
-
You can come back to project settings and download the file from there, or delete it so it can be generated again
Importing the project
-
The new GitLab project import feature is at the far right of the import options on New Project
-
After choosing a namespace or path, you can then select the file exported previously
-
Click on Import to begin importing and you will see your newly imported project page soon
Advanced
The GitLab Import/Export version can be checked by using:
cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:import_export:version RAILS_ENV=production
The current list of DB tables that will get exported can be listed by using:
cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:import_export:data RAILS_ENV=production