# 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](https://docs.linuxfoundation.org/lfx/easycla/v2-current/project-managers/view-connection-status-of-git-organizations-and-repositories)​
* ​[Enforce or Remove CLA Mechanism from GitLab Projects​](https://docs.linuxfoundation.org/lfx/easycla/v2-current/enforce-or-remove-cla-mechanism#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](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-38e585e9283ba8095ec7203eaccb51c181bded19%2Fadd%20and%20manage%20repositories.png?alt=media\&token=d6addd9c-e92d-4889-96bc-a5330545d762)

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

![Add GitLab Group](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-18cadb0dd0a93a19038e103edb6dec65a9b2b28f%2Fadd%20gitlab%20group.png?alt=media)

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](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-31258b9bc17fdd7ddba1330f2e89503cd8b68d7e%2Fconnect%20gitlab%20group.png?alt=media)

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

![Install GitLab EasyCLA App](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-218ed90b1a2f8bc2194b7cf5856aae191ec259da%2Finstall%20gitlab%20easycla%20app.png?alt=media)

9\. Click **Authorize**.

10\. Installation Successful window appears. Close the window, navigate to the Project Control Center, and click **I'm Done Installing**.

**Note:** If you do not click **I'm Done Installing**, you will have to reinstall EasyCLA application.

![GitLab I am done Installing](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-779324e7ba11e75329090056b1063a05fe37ff79%2Fgitlab%20i%20am%20done%20installing.png?alt=media)

{% 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](https://docs.linuxfoundation.org/lfx/easycla/v2-current/enforce-or-remove-cla-mechanism#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 all the branches of the GitLab group. If you select this check box, you do not need to [enable branch protection manually](https://docs.linuxfoundation.org/lfx/easycla/getting-started/easycla-troubleshooting/easycla-disabled#enable-branch-protection).
* **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="https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-dd7e80291a6fb51e862cd150a1b98cdc2cbefa49%2Fsettings.png?alt=media" 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](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-282f6a9fd503f37175f4fd92e59fd96ea7550ea2%2Fadditional%20setttings%20GitLab.png?alt=media)

## 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](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-b34628e4902f7c973f3df2e1835843464c331bb7%2Fdisassociate%20gitlab%20group%20disabled.png?alt=media)

1. Click the settings icon <img src="https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-dd7e80291a6fb51e862cd150a1b98cdc2cbefa49%2Fsettings.png?alt=media" 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](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-674c71508ea9c8080cf0a5ae828d10277d8566c8%2Fdisassociate%20gitlab%20group.png?alt=media)
