gitlab-org--gitlab-foss/doc/gitlab-basics/create-group.md

51 lines
1.8 KiB
Markdown
Raw Normal View History

2015-07-02 15:09:06 -04:00
# How to create a group in GitLab
2015-07-31 11:21:53 -04:00
Your projects in GitLab can be organized in 2 different ways:
under your own namespace for single projects, such as `your-name/project-1` or
under groups.
2015-07-02 15:09:06 -04:00
If you organize your projects under a group, it works like a folder. You can
manage your group members' permissions and access to the projects.
2015-07-07 15:49:58 -04:00
---
2015-07-02 15:09:06 -04:00
To create a group:
2015-07-02 15:09:06 -04:00
1. Expand the left sidebar by clicking the three bars at the upper left corner
and then navigate to **Groups**.
2015-07-02 15:09:06 -04:00
![Go to groups](img/create_new_group_sidebar.png)
2015-07-02 15:09:06 -04:00
1. Once in your groups dashboard, click on **New group**.
2015-07-07 15:49:58 -04:00
![Create new group information](img/create_new_group_info.png)
2015-07-02 15:09:06 -04:00
1. Fill out the needed information:
2015-07-02 15:09:06 -04:00
1. Set the "Group path" which will be the namespace under which your projects
will be hosted (path can contain only letters, digits, underscores, dashes
and dots; it cannot start with dashes or end in dot).
1. The "Group name" will populate with the path. Optionally, you can change
it. This is the name that will display in the group views.
1. Optionally, you can add a description so that others can briefly understand
what this group is about.
1. Optionally, choose and avatar for your project.
1. Choose the [visibility level](../public_access/public_access.md).
2015-07-02 15:09:06 -04:00
1. Finally, click the **Create group** button.
2015-07-02 15:09:06 -04:00
## Add a new project to a group
2015-07-02 15:09:06 -04:00
2015-07-07 15:49:58 -04:00
There are 2 different ways to add a new project to a group:
2015-07-02 15:09:06 -04:00
- Select a group and then click on the **New project** button.
![New project](img/create_new_project_from_group.png)
2015-07-02 15:09:06 -04:00
You can then continue on [creating a project](create-project.md).
2015-07-02 15:09:06 -04:00
- While you are [creating a project](create-project.md), select a group namespace
you've already created from the dropdown menu.
2015-07-02 15:09:06 -04:00
![Select group](img/select_group_dropdown.png)