@@ -17,24 +17,31 @@ Starting at version 13, group export has been deprecated in favor of this proces
5. Fill in the details for the group, including the https URL and access token.
6. The group will be imported after a few minutes.
### Group Migration (File Export)
1. On the source instance, go to the group and select Settings > General > Advanced > Export Group. This downloads the compressed group to your computer.
2. On the destination instance, select the group you want to export groups to, and click on New Group.
3. Select Import Group
5. Fill in the details for the group and select the group file on your local computer.
6. The group will be imported after a few minutes.
### Group/Project Export
## Group Export
If the clients' self-managed instance is not accessible by HTTPS, you must follow this process. It involves taking archive downloads of each group and project you want to migrate over. The process is generally the same for groups and projects
1. From the source instance, you will need to be an Administrator or an Owner of the project/group. The items will be downloaded as zip files.
2. Find the project/group you are looking for, select on the left Settings > General > Advanced
3. Scroll down to Export Project/Group and generate an export. Wait a few minutes, you may need to refresh the page.
3. Scroll down to Export Group and generate an export. Wait a few minutes, you may need to refresh the page.
4. Download the export and keep the archive where you can easily access it.
5. On the destination instance, select the group you want to export the project/group to and click on New Project
6. Select Import Project
5. On the destination instance click on New Group
6. Select Import Group
7. Select GitLab export
8. Fill in the details for the project/group
9. The project will be imported after a few minutes
8. Fill in the details for the group
9. The group will be imported after a few minutes
## Project Migration (API)
1. On the source instance, create a personal access token. Give yourself all permissions to keep things simple. Save the token to your clipboard, we will use it later.
2. On the destination instance, click on New Project.
3. Select Import Project and then Repository by URL.
5. Fill in the details for the project, including the https URL and access token.
6. The project will be imported after a few minutes.
## Project Export
1. On the source instance, go to the project and select Settings > General > Advanced > Export Project. This downloads the compressed group to your computer.
2. On the destination instance click on New Project.
3. Select Import Project
5. Fill in the details for the group and select the project file on your local computer.
6. The project will be imported after a few minutes.
## Migrating from SAAS to Self-Managed
This details migrating from gitlab.com to a self-managed VM.
