import_export.md 2.61 KB
Newer Older
1 2
# Project import/export

3
>**Notes:**
4 5 6
  - This feature was [introduced][ce-3050] in GitLab 8.9
  - Importing will not be possible if the import instance version is lower
    than that of the exporter.
7 8 9 10
  - For existing installations, the project import option has to be enabled in
    application settings (`/admin/application_settings`) under 'Import sources'.
    Ask your administrator if you don't see the **GitLab export** button when
    creating a new project.
11
  - You can find some useful raketasks if you are an administrator in the
12
    [import_export](../../../administration/raketasks/project_import_export.md)
13
    raketask.
14 15
  - The exports are stored in a temporary [shared directory][tmp] and are deleted
    every 24 hours by a specific worker.
16

17 18 19 20 21
Existing projects running on any GitLab instance or GitLab.com can be exported
with all their related data and be moved into a new GitLab instance.

## Exported contents

22
The following items will be exported:
23

24 25 26 27 28
- 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
29

30
The following items will NOT be exported:
31

32 33
- Build traces and artifacts
- LFS objects
34

35
## Exporting a project and its data
36

37
1. Go to the project settings page by clicking on **Edit Project**:
38

39
    ![Project settings button](img/settings_edit_button.png)
40

41
1. Scroll down to find the **Export project** button:
42

43
    ![Export button](img/import_export_export_button.png)
44

45
1. Once the export is generated, you should receive an e-mail with a link to
46
   download the file:
47

48
    ![Email download link](img/import_export_mail_link.png)
49

50
1. Alternatively, you can come back to the project settings and download the
51 52
   file from there, or generate a new export. Once the file available, the page
   should show the **Download export** button:
53

54
    ![Download export](img/import_export_download_export.png)
55

56
## Importing the project
57

58 59
1. The new GitLab project import feature is at the far right of the import
   options when creating a New Project. Make sure you are in the right namespace
60
   and you have entered a project name. Click on **GitLab export**:
61

62
    ![New project](img/import_export_new_project.png)
63

64
1. You can see where the project will be imported to. You can now select file
65
   exported previously:
66

67
    ![Select file](img/import_export_select_file.png)
68

69
1. Click on **Import project** to begin importing. Your newly imported project
70
   page will appear soon.
71 72

[ce-3050]: https://gitlab.com/gitlab-org/gitlab-ce/issues/3050
73
[tmp]: ../../../development/shared_files.md