@@ -9,18 +9,25 @@ Before beginning with the migration you need to know these details:
- The client should be at the most recent version of GitLab. If they are not, you should follow an upgrade [process](https://gitlab.com/groups/nextlink/-/wikis/Gitlab/Gitlab-Upgrades).
Once at the most recent version of GitLab, there are two primary methods for migrating data to SAAS.
### Group/Project Migration
Starting at version 13, project and group export has been deprecated in favor of this process.
### Group Migration
Starting at version 13, group export has been deprecated in favor of this process.
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, select the group you want to export groups to, and click on New Group
3. Select Import Group
5. Fill the details for the group, including the https URL and access token.
6. The group will be imported after a few minutes.
### Group/Project 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.
1. From the source instance, you will need to be an Administrator or an Owner of the project. Projects will be downloaded as zip files
2. Find the project you are looking for, select on the left Settings > General > Advanced
3. Scroll down to Export Project and generate an export. Wait a few minutes, you may need to refresh the page.
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.
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 projects to, and click on New Project
5. On the destination instance, select the group you want to export project/group to, and click on New Project
6. Select Import Project
7. Select GitLab export
8. Fill the details for the project
8. Fill the details for the project/group
9. The project will be imported after a few minutes
