> ## 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.

# Setup the GitLab integration in App Settings

> Add GitLab credentials to Portal App Settings.

## Overview

This step will guide you through the process of adding the needed configuration and credentials to App Settings so Portal can connect to GitLab.

### Step Checklist

This is the first (1) step in this guide, once completed you can move onto the next step.

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

## Walkthrough

The GitLab integration is managed in Portal under App Settings > Integrations. Open the GitLab card there to configure the host and credentials Portal should use.

<Frame>
  <img
    src="https://mintcdn.com/spotify-89f50c35/vAIwtfnEDW2fYb5m/portal/assets/gitlab-new-integration.png?fit=max&auto=format&n=vAIwtfnEDW2fYb5m&q=85&s=0b85cc9823de953577e0acd6aa4125b7"
    alt="GitLab integration settings in App Settings
Integrations"
    width="1339"
    height="730"
    data-path="portal/assets/gitlab-new-integration.png"
  />
</Frame>

After saving the configuration, wait for Portal to apply the new settings and reload when prompted.

From here you can now move on to Step 2 where you'll [setup GitLab Discovery](./gitlab-discovery).

<Info>
  If you are using a self-managed GitLab instance behind a firewall, make sure
  Portal Connect allows access to the GitLab API before saving this integration.
</Info>