BigW Consortium Gitlab

create-group.md 1.65 KB
Newer Older
1 2
# How to create a group in GitLab

karen Carias committed
3
Your projects in GitLab can be organized in 2 different ways:
4 5
under your own namespace for single projects, such as `your-name/project-1` or
under groups.
6

7 8
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.
karen Carias committed
9

10
---
11

12
To create a group:
13

14 15
1. Expand the left sidebar by clicking the three bars at the upper left corner
   and then navigate to **Groups**.
16

17
    ![Go to groups](img/create_new_group_sidebar.png)
18

19
1. Once in your groups dashboard, click on **New group**.
karen Carias committed
20

21
    ![Create new group information](img/create_new_group_info.png)
22

23
1. Fill out the needed information:
24

25 26 27 28 29 30 31
    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. 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).
32

33
1. Finally, click the **Create group** button.
34

35
## Add a new project to a group
36

karen Carias committed
37
There are 2 different ways to add a new project to a group:
38

39 40 41
- Select a group and then click on the **New project** button.

    ![New project](img/create_new_project_from_group.png)
42

43
    You can then continue on [creating a project](create-project.md).
44

45 46
- While you are [creating a project](create-project.md), select a group namespace
  you've already created from the dropdown menu.
47

48
    ![Select group](img/select_group_dropdown.png)