---
description: Linking GitLab to Aude
---

# GitLab

At the current time, Aude supports GitLab Cloud. [Let us know](../billing-+-support) if you have a particular use case for GitHub on-premises.

Aude supports connecting to GitLab groups. You'll need to setup an application and an app access token. Then using the provided information from each step, connect to the GitLab installation.

## 1. Setup application

The application is used to provide an Oauth link from Aude to GitLab, to allow users to login with their own GitLab accounts.

1. Visit the `Applications`page in your group's settings

&#x20;![](https://3790432678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKeXGH4g5EHNulArRSXU%2Fuploads%2FKoyINHWkhfBDTNtUPA8P%2Fimage.png?alt=media\&token=644068b8-c794-4c7b-bfcf-984653c05a21)

2. Click `Add new application` and configure it as follows:&#x20;
   1. **Name:** Aude
   2. **Redirect URI:** `https://server.aude.app/api/identity/oauth/gitlab/callback`&#x20;
   3. **Scopes:** `read_api`
   4. **Confidential:** No
3. The new application will be created. Take note of its **Application ID.**

## 2. Setup app access token

An app access token is required for background reindexing of the code repositories. You need to ensure the app access token user has permission to access all the repositories in the group so reindexing occurs successfully.

Preferably, you should [create a Group Access Token](https://docs.gitlab.com/user/group/settings/group_access_tokens/) (requires paid GitLab plan). However, any app access token works, such as a [Personal Access Token](https://docs.gitlab.com/user/profile/personal_access_tokens/). as long as it has the required permissions to access the repositories.

Ensure the access token is setup with `read_api` scope.

{% hint style="info" %}
Access tokens have an expiry date. You will need to update the installation with Aude with the new access token prior to expiry to ensure indexing continues uninterrupted.
{% endhint %}

Once you've created the access token, take note of it.

## 3. Link installation in Aude

From Aude configuration, you may find the **Link GitLab Installation** button. Click it and fill the following details.

<figure><img src="https://3790432678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKeXGH4g5EHNulArRSXU%2Fuploads%2FOlb4noV1OAPOYUcmUEtH%2Fimage.png?alt=media&#x26;token=38e8620d-5594-4e41-8daf-1052fadaec53" alt=""><figcaption></figcaption></figure>

1. **Group ID:** You may find this via the GitLab group's main page.

<figure><img src="https://3790432678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKeXGH4g5EHNulArRSXU%2Fuploads%2FTEsV2xYnB9FKMOyZcONu%2Fimage.png?alt=media&#x26;token=1a79fb10-13d4-481d-8ee1-d8ae07b9acd9" alt=""><figcaption></figcaption></figure>

2. **Application ID:** From the prior step.
3. **App Access Token:** From the prior step.

Once the installation is linked, you'll need to **Log in** into it. Following this, all the code repositories you have permission to access will be linkable via the **Link repository** button.&#x20;
