---
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-10-09"
---

# GitLab repository integration
> **Note**: The GitLab repository integration is only available to [Fabric](https://docs.getdx.com/fabric-start-guide/) customers.

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)