# Add and Manage GitLab Groups

Before you can add or manage GitLab groups and projects, you must connect or add GitLab groups while setting up IT services. However, you can also add GitLab groups in the GitLab pane of **Tools** tab.

{% hint style="info" %}
**Note**:

* In GitLab, *organizations* are mentioned as *groups*, and *repositories* are mentioned as *projects*.

* You must be the owner of the GitLab group which you want to connect for CLA mechanism.
  {% endhint %}

* ​[Add GitLab Groups](#add-gitlab-groups)​

* ​[Enable Branch Protection and Auto Enable New Repositories](#enable-branch-protection-and-auto-enable-new-repositories)​

* ​D[isassociate GitLab Groups](#disassociate-gitlab-groups)​

After you successfully add Git organizations, you can:

* [​View Connection Status of Git Organization and Repositories](/lfx/easycla/v2-current/project-managers/view-connection-status-of-git-organizations-and-repositories.md)​
* ​[Enforce or Remove CLA Mechanism from GitLab Projects​](/lfx/easycla/v2-current/project-managers/enforce-or-remove-cla-mechanism.md#enforce-or-remove-cla-mechanism-from-gitlab-projects)

## Add GitLab Groups <a href="#add-gitlab-groups" id="add-gitlab-groups"></a>

1\. Sign in to the [Project Control Center](https://projectadmin.lfx.linuxfoundation.org).

2\. Click a **project** of interest.

3\. Scroll down to the **Tools** **Status** section, and click **EasyCLA**.

**Note:** You can also connect the GitLab groups during IT setup in the IT Services Status section, and then install the EasyCLA application in the Tools Status section to add it for the CLA process.

4\. Under CLA Groups, select a CLA group to which you have added the project.

5\. Click **Manage** next to the project for which you want to manage repositories.

![Add and Manage Repositories](/files/-MYLD72mIvpAdv9fFlZ4)

6\. Under the GITLAB tab, click the **+** sign at the top right of ADD GITLAB GROUP.

![Add GitLab Group](/files/-MiPcqDDRfIYvatzDsaY)

7\. Provide the complete URL of the GitLab group, as shown in the image, in the **Enter GitLab Group URL** field, and click **Connect**.

![Connect GitLab Group](/files/-MiPdsW4DbRxTg7b1Rb5)

8\. Click **Install GitLab EasyCLA App**.

![Install GitLab EasyCLA App](/files/-MiPg2EpWrcICW6p6vSm)

9\. Click **Authorize**.

10\. After GitLab shows the success page, close that tab, return to the Project Control Center, and click **I'm Done Installing**.

**Note:** If you have already authorized the GitLab installation previously, GitLab may skip the authorization page and go directly to the success page. If you do not click **I'm Done Installing**, you will have to reinstall the EasyCLA application.

![GitLab I am done Installing](/files/-MiPi8H7IPV1A4ngjBSv)

{% hint style="info" %}
**Note:**

1.LFX EasyCLA adds all the projects, including projects under subgroups, of the GitLab group to the Project Control Center.

2.To enable a CLA mechanism on a project, you must [enforce CLA mechanism](/lfx/easycla/v2-current/project-managers/enforce-or-remove-cla-mechanism.md#enforce-or-remove-cla-mechanism-from-gitlab-projects) for GitLab projects. Simply adding a GitLab group to the project does not enable the EasyCLA mechanism for any GitLab project.

3.To review the configuration or revoke the application, navigate to the *GitLab Applications under your User Settings*.
{% endhint %}

## Enable Branch Protection and Auto Enable New Repositories <a href="#enable-branch-protection-and-auto-enable-new-repositories" id="enable-branch-protection-and-auto-enable-new-repositories"></a>

After adding the GitLab group, you should enable branch protection and auto enable new repositories.

* **Enable Branch Protection** automatically enables the EasyCLA check for each GitLab project's default branch. If non-default branches also require EasyCLA protection, configure those branches manually in GitLab. If you select this check box, you do not need to [enable branch protection manually](/lfx/easycla/v2-current/getting-started/easycla-troubleshooting/easycla-disabled.md#enable-branch-protection) for the default branch.
* **Auto Enable New Repositories** automatically adds a repository under the GitLab group on the project console when you add a project to the GitLab group.

**To enable branch protection and auto enable new repositories:**

1\. Click the settings icon <img src="/files/-MCM2JfE9dPjlsLUyjJG" alt="" data-size="line">next to **Additional Settings** for a GitLab group.

2\. Click both the check boxes, and click **Save Changes**.

![Additional Settings GitLab](/files/-MitZdX8TRK_724q9gMF)

## Disassociate GitLab Groups <a href="#disassociate-gitlab-groups" id="disassociate-gitlab-groups"></a>

**Note**: To disassociate a GitLab group, you must disable CLA from all projects of the GitLab group.

![Disassociate GitLab Group disabled for CLA enforced Projects](/files/-MlEm0yjikCAqyhShrV3)

1. Click the settings icon <img src="/files/-MCM2JfE9dPjlsLUyjJG" alt="" data-size="line">next to **Additional Settings** for a GitLab group.
2. Click **Disassociate GitLab Group**, and click **Disassociate** on the confirmation window.

![Disassociate GitLab Group](/files/-MlEmJKzhdUeO_X4yUpz)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.linuxfoundation.org/lfx/easycla/v2-current/project-managers/add-and-manage-gitlab-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
