Tutorial: Move your personal project to a group
If you created a project under a personal namespace, you can perform common tasks, like managing issue and merge requests, and using source control and CI/CD.
However, at some point you might outgrow your personal project and want to move your project to a group namespace instead. With a group namespace, you can:
- Give a group of users access to your project, rather than adding users one-by-one.
- View all issues and merge requests for all projects in the group.
- View all unique users in the group namespace, across all projects.
- Manage usage quotas.
- Start a trial or upgrade to a paid subscription tier. This option is important if you’re impacted by the changes to user limits, and need more users.
This tutorial shows you how to move your project from a personal namespace to a group namespace.
Here’s an overview of the steps:
Create a group
To begin, make sure you have a suitable group to move your project to. The group must allow the creation of projects, and you must have at least the Maintainer role for the group.
If you don’t have a group, create one:
- On the top bar, select Main menu > Groups > View all groups.
- On the right of the page, select New group.
- In Group name, enter a name for the group.
- In Group URL, enter a path for the group, which is used as the namespace.
- Choose the visibility level.
- Optional. Fill in information to personalize your experience.
- Select Create group.
Move your project to a group
Before you move your project to a group:
- You must have the Owner role for the project.
- Remove any container images
- Remove any npm packages. If you transfer a project to a different root namespace, the project must not contain any npm packages. When you update the path of a user or group, or transfer a subgroup or project, you must remove any npm packages first. You cannot update the root namespace of a project with npm packages. Make sure you update your .npmrc files to follow the naming convention and run npm publish if necessary.
Now you’re ready to move your project:
- On the top bar, select Main menu > Projects and find your project.
- On the left sidebar, select Settings > General.
- Expand Advanced.
- Under Transfer project, choose the group to transfer the project to.
- Select Transfer project.
- Enter the project’s name and select Confirm.
You are redirected to the project’s new page. If you have more than one personal project, you can repeat these steps for each project.
Work with your group
You can now view your project in your group:
- On the top bar, select Main menu > Groups and find your group.
- Look for your project under Subgroups and projects.
Start enjoying the benefits of a group! For example, as the group Owner, you can quickly view all unique users in your namespace:
- In your group, select Settings > Usage Quotas.
- The Seats tab displays all users across all projects in your group.