# GitHub

By installing the Paradime GitHub app within your organization, you can enable features like:

* **CI/CD Automation**: Trigger automated workflows ([Lineage Diff](https://docs.paradime.io/app-help/documentation/bolt/ci-cd/lineage-diff), [Turbo CI](https://docs.paradime.io/app-help/documentation/bolt/ci-cd/turbo-ci)) when a Pull Request is opened. 
* [**Radar's Cost Optimization**](https://docs.paradime.io/app-help/documentation/radar): Gain insights and optimize data warehouse costs. 
* DinoAI PR Tool: 

***

## Connect the GitHub App integration <a href="#enabling-the-integration" id="enabling-the-integration"></a>

{% hint style="warning" %}
You must be a **GitHub organization owner** to install the Paradime GitHub integration. [Learn more about GitHub organization roles](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization).&#x20;
{% endhint %}

To install the GitHub integration, follow these steps:

1. **Open your Paradime Account Settings**: Go to **Settings > Integrations**.
2. **Select GitHub Integration**: Find the **GitHub** integration and click **Connect**.
3. **Authenticate with GitHub**: You’ll be redirected to GitHub to complete the authentication process.
4. **Select Git Repositories**:  Based on your GitHub organization role, follow the steps below.

{% tabs %}
{% tab title="GitHub Organization Owner" %}

1. **Choose Repositories**: After authenticating, select the repositories you want to connect to Paradime from the dropdown list.
2. **Authorize the GitHub App**: Click `Install and authorize`  to complete the Github Installation process.&#x20;

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FAJKWF4K3mvRORyaniD46%2Fimage.png?alt=media&#x26;token=6dee9ae6-1374-4423-b6d0-1011b31a1a48" alt="" width="464"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Request from Organization Owner" %}
If you are **not a GitHub organization owner**, you can request the installation by following these steps:

1. **Select GitHub Organization**: After authenticating, choose the GitHub organization where you want the Paradime integration installed.
2. **Click "Authorize & Request"**: This will send an automated installation request to your GitHub organization owner.

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FvU8mJNWSQUmXfLr8PZ0R%2Fimage%20(1).png?alt=media&#x26;token=5a61f64b-560f-4738-b374-61b799a836d4" alt="" width="311"><figcaption></figcaption></figure>

3. **Notify Your Admin**: Paradime will send an automated email to your GitHub organization Owner with instructions on how to complete the installation. You can also forward this email to the admin or provide the admin’s email to send it directly through Paradime.

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2Fm3qfpnqAZXTSUAFTbeVs%2Fimage.png?alt=media&#x26;token=fb1954aa-da69-4bdd-a58c-5174e1db870e" alt=""><figcaption></figcaption></figure>

***

#### Completing the Installation

{% hint style="danger" %}
**To complete the configuration, the GitHub admin will need to enter your Paradime organization name as part of the installation.**
{% endhint %}

To finalize the installation, the GitHub Org Owner will need to follow these this guide to complete the installation:&#x20;

{% @arcade/embed flowId="Cgn5xpav6BK7dxQEoIoJ" url="<https://app.arcade.software/share/Cgn5xpav6BK7dxQEoIoJ>" %}

Once approved, the GitHub integration will be active and ready to use.
{% endtab %}

{% tab title="Update GitHub app permissions" %}
If you have already connected the Paradime GitHub app and want to grant access to more repositories connected in your Paradime Workspace follow the below steps:

1. **Navigate to Settings:** In your GitHub Organization home page, click on the setting option (Not your repository settings).
2. **Select GitHub Apps**: In the left panel, under "Third-party Access", select "GitHub Apps"
3. **Configure the Paradime App**: find the Paradime App you have already installed, and click on the "Configure" button.
4. **Update Repository Access**: In the repository access section, you should see the list of repositories for which the Paradime App has been already granted access.  Click on the "Select repositories" menu and select your new repository.
5. **Save your settings:** When done, click on the "Save" button to update the permissions.

{% @arcade/embed flowId="1Gf1BgmhY0js1lylLmZR" url="<https://app.arcade.software/share/1Gf1BgmhY0js1lylLmZR>" %}
{% endtab %}
{% endtabs %}

## Connect GitHub user level OAuth

{% hint style="warning" %}
After connecting the GitHub app integration to Paradime, Paradime user should complete the user level OAuth to complete the setup and use CI/CD features.
{% endhint %}

To set up user-level OAuth:

1. **Go to Profile Settings**: Navigate to **Profile > Profile Settings**. This will redirect you to Github.
2. **Connect GitHub Integration**: Click `Authorize Paradime`

{% @arcade/embed flowId="dN7cZrCWrzX8TvCxQmmt" url="<https://app.arcade.software/share/dN7cZrCWrzX8TvCxQmmt>" %}