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

# GitLab

> Connect GitLab repositories to Sidecar through OAuth

Connect GitLab to let Sidecar read accessible repositories and deliver Agent Console branches and merge requests.

## Before you start

You need an Account Admin role in Sidecar and a GitLab account with access to the target repositories.

Sidecar supports `gitlab.com`. Self-managed GitLab instances are not supported by this integration.

## Connect GitLab

<Steps>
  <Step title="Open GitLab in Integrations">
    In Sidecar, select **Integrations**, then open **GitLab**.

    <Frame caption="Start the GitLab OAuth flow from the disconnected integration page.">
      <img src="https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/integrations/source-control/gitlab-disconnected.png?fit=max&auto=format&n=73rR_9_1tURjMaYe&q=85&s=0327466d0d009c796f79bd3794e9e4db" alt="Disconnected GitLab integration with Connect GitLab with OAuth button" width="1230" height="650" data-path="images/integrations/source-control/gitlab-disconnected.png" />
    </Frame>
  </Step>

  <Step title="Authorize Sidecar">
    Click **Connect GitLab with OAuth**. Review the requested access in GitLab and authorize Sidecar.
  </Step>

  <Step title="Return to Sidecar">
    Sidecar completes verification and displays the connected GitLab identity.
  </Step>
</Steps>

To refresh the authorization later, click **Reconnect GitLab**.

## Verify Agent Console access

Open an agent's **Settings** page and check **Scope → Repositories**. See [Connect repositories](/products/agent-console/setup/connect-repositories) for job-scope behavior.