---
title: "GitLab repository integration"
canonical_url: "https://docs.getdx.com/catalog/gitlab-repository-integration/"
md_url: "https://docs.getdx.com/catalog/gitlab-repository-integration.md"
last_updated: "2026-05-22"
---

# GitLab repository integration
By setting up the GitLab repository integration, you enable the DX Catalog to read file contents from your GitLab projects. This is required to use file matching rules and other repository-aware features.

## Prerequisites

To connect GitLab to the DX Catalog, you need:

- a GitLab account that can create a [Group Access Token](https://docs.gitlab.com/user/group/settings/group_access_tokens/) or a [Service Account](https://docs.gitlab.com/user/profile/service_accounts/)
- allowlist [DX IP addresses](https://docs.getdx.com/allowlisting-dx/) if your GitLab instance is behind a firewall or has IP restrictions

## Setup instructions

Follow the steps below to connect GitLab to the DX Catalog.

#### Step 1

Either create a Group Access Token with the **Developer** role and the **read_api** scope, or create a group service account, add it to the group with the **Developer** role, and create an access token with the **read_api** scope.

#### Step 2

Grant the group access to the projects whose repositories the Catalog should read.

#### Step 3

- Navigate to the **Catalog** settings in DX and open the **Repository integrations** section. Click **Add integration**, choose **GitLab**, and enter a name and your **Personal access token** (the token value from Step 1).
- If you use a self-hosted GitLab instance, enter its root URL in the **GitLab instance URL** field (for example, `https://gitlab.example.com`). Leave this field blank to use GitLab.com.
- DX verifies the token and scopes; when verification succeeds, the integration is saved.
---

## Sitemap

[Overview of all docs pages](/llms.txt)