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

# GitLab OAuth App (Sign in with GitLab)

Use this if you want users to sign in to Kodus with GitLab. This is separate from the GitLab webhook integration used for code review automation.

## Prerequisites

* **WEB\_DOMAIN**: Your Frontend URL (e.g., `https://app.yourdomain.com` or `http://localhost:3000`)

## Step 1: Create the OAuth App

1. In GitLab, go to **User Settings** > **Applications**
2. Click **New application**
3. Fill in the application name and the redirect URI

## Step 2: Configure the Callback URL

Set the **Redirect URI** to:

```
WEB_DOMAIN/api/auth/callback/gitlab
```

Make sure the URL matches your actual web domain and scheme (http/https).

## Step 3: Configure Scopes

Set the scopes in GitLab to match the scopes below:

```
WEB_GITLAB_SCOPES="read_api read_user read_repository"
```

## Step 4: Add Credentials to .env

After creating the app, copy the credentials from GitLab and add them to your Kodus environment:

```
WEB_OAUTH_GITLAB_CLIENT_ID="your_client_id_here"
WEB_OAUTH_GITLAB_CLIENT_SECRET="your_client_secret_here"
WEB_GITLAB_SCOPES="read_api read_user read_repository"
WEB_GITLAB_OAUTH_URL="https://gitlab.com/oauth/authorize"
```

For self-managed GitLab, replace the OAuth URL with your instance domain (e.g., `https://gitlab.yourdomain.com/oauth/authorize`).

## Summary of Environment Variables

```bash theme={null}
WEB_OAUTH_GITLAB_CLIENT_ID="your_client_id_here"
WEB_OAUTH_GITLAB_CLIENT_SECRET="your_client_secret_here"
WEB_GITLAB_SCOPES="read_api read_user read_repository"
WEB_GITLAB_OAUTH_URL="https://gitlab.com/oauth/authorize"
```

Restart the web application to apply the changes.