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

# GitLab

> Integrate GitLab with Portal for supported GitLab-backed workflows.

## How to integrate GitLab

This guide will walk you through how to integrate GitLab with Portal so supported Portal features can connect to your GitLab repositories. You'll need to be a Portal Admin to complete this guide.

<Info>
  In Portal, the GitLab integration is managed under App Settings >
  Integrations.
</Info>

<Tip>
  For self-managed GitLab instances that Portal cannot reach directly, set up
  [Portal Connect](/docs/portal/guides/portal-connect) before moving forward so
  Portal can communicate with your GitLab API.
</Tip>

## Steps Overview

To accomplish the goals set above this guide will take you through the following steps:

1. [Setup the GitLab integration in App Settings](./gitlab-app-settings-integrations)
2. [Setup GitLab Discovery](./gitlab-discovery)

## Related Documentation

* [GitLab Soundcheck integration](/docs/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/gitlab) - Collect GitLab-specific facts for Soundcheck checks