# Add and Manage GitHub Organizations

Before you can add or manage GitHub organizations and repositories, you must connect or add GitHub organizations while setting up IT services. However, you can also add GitHub organization in the GitHub pane of **Tools** tab.

* ​[Add GitHub Organization](#add-github-organization)​
* ​[Enable Branch Protection and Auto Enable New Repositories](#enable-branch-protection-and-auto-enable-new-repositories)​
* ​[Disassociate GitHub Organization​](#disassociate-github-organization)

After you successfully add GitHub organization, 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 GitHub Repositories](https://docs.linuxfoundation.org/lfx/easycla/v2-current/enforce-or-remove-cla-mechanism#enforce-or-remove-cla-mechanism-from-github-repositories)​

## Add GitHub Organization <a href="#add-github-organization" id="add-github-organization"></a>

{% hint style="info" %}
**Prerequisite:** You must be the owner of the GitHub organization which you want to connect for CLA mechanism.
{% endhint %}

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 GitHub organization during IT set up in the **IT Services Status** section, and then install EasyCLA application in **Tools Status** section to add it for 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 GitHub tab, click the **+** sign at the top right of Add GitHub Organization.

![Add GitHub Organization](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-9f7e0912b710323c8fe13942c0c24b7c2a2f6c07%2Fadd%20github%20organization.png?alt=media\&token=0aabbd25-bf86-48d7-92ae-f02b5879943e)

7\. Type the GitHub organization name in the **Enter GitHub Organization** field, and click **Connect**.

![Connect GitHub Organization](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-88904ad2dfdd7756028e9176e39f226b296c4326%2Fconnect%20github%20organization.png?alt=media\&token=64456dd4-df3a-4569-8e85-c923cb688884)

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

![Install GitHub EasyCLA App](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-64f1beb5260694ecc3ab2544920255ccaae5ab72%2Finstall%20github%20easycla%20app.png?alt=media\&token=9f1d8b16-803c-4136-bb1c-76f9157d2f79)

9\. Sign in to GitHub if the sign-in window appears, and click **Configure**.

10\. Select the organization that you want to enroll for CLA mechanism.

​11. Select repositories, and click **Install**.

![Selecting Individual repositories and Install EasyCLA App](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-8b8f7519595c9bfc551764027b9d3b356c3f90e9%2Fselecting%20individual%20repositories.png?alt=media\&token=9457e09f-0477-4b89-9761-a48a046bdcbe)

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

If you select **Only select repositorie**s, then a newly added repository to the GitHub organization will not be reflected automatically under the project's GitHub organization page in Project Console.​​
{% endhint %}

12\. Navigate to the Project Control Center, and click **I'm Done Installing**.

{% hint style="warning" %}
**Important:** To enable a CLA mechanism on a repository, you must [enforce CLA mechanism for GitHub repositories](https://docs.linuxfoundation.org/lfx/easycla/v2-current/enforce-or-remove-cla-mechanism#enforce-or-remove-cla-mechanism-from-github-repositories). Simply adding a GitHub organization to the project does not enable the EasyCLA mechanism for any CLA groups.
{% endhint %}

![GitHub Installation Completed](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-c359e719acc024adf49517898b7089d9b432a1dc%2Finstallation%20completed.png?alt=media\&token=51c36ba3-ee6f-475d-814e-c6c72ea1bd6d)

## 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 GitHub organization, you should enable branch protection and auto enable new repositories.

* **Enable Branch Protection** automatically enables the EasyCLA check for all the branches of the GitHub organization. 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 GitHub organization on the project console when you add the repository to the GitHub organization.

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 GitHub organization.

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

![Additional Settings](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-00db4232a1ee706564995a9b26813632d2aa512c%2Fadditional%20setttings.png?alt=media\&token=df925bc3-ace0-4c36-8e96-4458e277ea72)

## Disassociate GitHub Organization <a href="#disassociate-github-organization" id="disassociate-github-organization"></a>

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 GitHub organization.

2\. Click **Disassociate GitHub Org**, and click the link to create a support ticket to disassociate the GitHub org.

![Disassociate GitHub Org](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-d88f662d090b9e5cd962264e57b2fb007dbb1bd9%2Fdisassociate%20github%20org.png?alt=media)
