> For the complete documentation index, see [llms.txt](https://aude-1.gitbook.io/aude/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aude-1.gitbook.io/aude/linking-installations/gitlab.md).
# GitLab
At the current time, Aude supports GitLab Cloud. [Let us know](/aude/billing-+-support.md) 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
2. Click `Add new application` and configure it as follows:
1. **Name:** Aude
2. **Redirect URI:** `https://server.aude.app/api/identity/oauth/gitlab/callback`
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.
1. **Group ID:** You may find this via the GitLab group's main page.
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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://aude-1.gitbook.io/aude/linking-installations/gitlab.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.