> ## Documentation Index
> Fetch the complete documentation index at: https://ai-development-environment.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up GitLab

> Connect GitLab.com or one self-hosted GitLab instance with an access token.

AIDE supports GitHub, GitLab, or both at the same time. Each provider appears as a separate navigation section only after its primary access token has been verified. **Settings** stays available when neither provider is configured.

## Requirements

* GitLab.com or GitLab 19.2 and newer
* An HTTPS instance URL
* A personal, project, or group access token with the `api` scope
* Access to each project you want AIDE to manage

The token's actual GitLab role and subscription tier determine which projects and actions are available. AIDE does not turn a lower-permission token into an administrator token.

## Connect an instance

<Steps>
  <Step title="Open Settings">
    Go to **Settings → Integrations → GitLab**.
  </Step>

  <Step title="Enter the instance root">
    Use `https://gitlab.com` or the root of your self-hosted installation, such as `https://code.example.com/gitlab`. Do not include `/api/v4`, credentials, a query, or a fragment.
  </Step>

  <Step title="Enter the access token">
    Paste a token with the `api` scope. AIDE sends it as `PRIVATE-TOKEN` only to the configured HTTPS origin and relative root.
  </Step>

  <Step title="Save and verify">
    AIDE calls `/api/v4/user` and `/api/v4/version`. Self-hosted versions older than 19.2 are rejected.
  </Step>
</Steps>

After verification, the settings card shows the GitLab identity, server version, and managed projects. The GitLab section appears immediately in web and iOS navigation.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/ai-development-environment/XmuMCFv09SOCZYoa/images/light/gitlab-settings.png?fit=max&auto=format&n=XmuMCFv09SOCZYoa&q=85&s=941eb46e75dda8829d7b84497b2866bd" alt="GitLab credentials card in Settings in light theme" width="3840" height="2160" data-path="images/light/gitlab-settings.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ai-development-environment/aldo79nFpNgOg3HT/images/dark/gitlab-settings.png?fit=max&auto=format&n=aldo79nFpNgOg3HT&q=85&s=8540d1c397247bdf8c3fe703fa20ee4a" alt="GitLab credentials card in Settings in dark theme" width="3840" height="2160" data-path="images/dark/gitlab-settings.png" />
</Frame>

<Warning>
  Never put a GitLab token in an environment variable committed to source control, a fixture, documentation, or an app log. AIDE stores it through the configured encrypted credential backend.
</Warning>

## Clear the integration

**Clear credentials** first tries to remove every project hook created by AIDE. If GitLab rejects cleanup, AIDE lists the affected projects and keeps the credentials so you can retry. **Force clear** removes the local credential after an explicit warning and can leave orphaned hooks in GitLab.

Removing GitLab does not affect GitHub. If GitLab is the current page, the navigation refreshes and moves to a valid destination.

## Related pages

<Columns cols={2}>
  <Card title="Managed projects" icon="folder" href="/gitlab/projects">Choose projects and configure hooks.</Card>
  <Card title="Self-hosting and TLS" icon="shield" href="/gitlab/self-hosting">Configure relative roots and private certificate authorities.</Card>
</Columns>