> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qodo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> This guide explains how to connect Qodo Context Engine to GitLab SaaS and GitLab Enterprise.

## 1. Generate a group access token

### Prerequisites

* You must be a **Group Owner** or **Maintainer**.
* **Only available on paid Premium or Ultimate tiers**. Group access tokens cannot be created on Free or trial plans.

### GitLab SaaS

<Steps>
  <Step title="Open your group">
    From the top bar, select **Menu**, then select **Groups** and select your group.
  </Step>

  <Step title="Go to the Access Tokens menu">
    From the left sidebar, click **Settings**, then select **Access Tokens**.
  </Step>

  <Step title="Fill out the form">
    * **Name**: any descriptive name
    * **Role**: Developer or above
    * **Scopes**: enable only:
      * `read_api`
      * `read_repository`
  </Step>

  <Step title="Click Create group access token" />

  <Step title="Copy and store the token immediately">
    The token is shown only once. Save it securely.
  </Step>
</Steps>

### GitLab Enterprise

**Prerequisites**

* You must be a **Group Owner** or **Maintainer**.
* Group access tokens can be created on **any license tier**, including Free.
* Token creation must be enabled:
  * Go to **Settings → General → Permissions and group features**
  * Ensure **Users can create project access tokens and group access tokens** is enabled

<Steps>
  <Step title="Open the target group">
    From the left side bar search or go to your target group.
  </Step>

  <Step title="Go to Access Tokens">
    From the left side bar choose **Settings**, then select **Access Tokens**.
  </Step>

  <Step title="Fill out the form">
    * **Name**: any descriptive name
    * **Role**: Developer or above
    * **Scopes**: enable only:
      * `read_api`
      * `read_repository`
  </Step>

  <Step title="Click Create group access token" />

  <Step title="Copy and store the token immediately">
    The token is shown only once. Save it securely.
  </Step>
</Steps>

## 2. Configure Qodo Context Engine

To connect your GitLab instance to Qodo Context Engine, **provide the following details to Qodo**:

* **GitLab domain** – For example: `gitlab.company.com`.
* **Group ID** – Available in the GitLab UI under your group’s name.
* **Access tokens** – Use the tokens generated during the previous step.

## 3. (Optional) Set a custom certificate bundle

If your self-hosted Git server uses a custom CA SSL certificate, share your ca-certificate.pem file with the Qodo team.