GitLab

This document tells you how to set up the GitLab authentication integration for NocoDB.

Environment Variables

To enable OAuth2 authentication with GitLab, set up these environment variables:

Step 1: Create a GitLab OAuth Application

1. Log in to your GitLab account.
2. Go to User Settings > Applications. For an organization-wide application, go to your Group settings > Applications.
3. Fill in the form:

• Name: Your application name (for example, "NocoDB")
• Redirect URI: The URL where GitLab sends users after authorization (for example, https://your-nocodb-instance.com/)
• Scopes: Select these scopes:
• api (API access)
• read_user (Read user information)
• read_repository (Read repository contents)
• write_repository (Write repository contents)

4. Click "Save application".

Step 2: Get Application ID and Secret

After you create your OAuth App, GitLab gives you:

• Application ID (Client ID)
• Secret (Client Secret)

Step 3: Set Environment Variables

Configure your NocoDB instance with these environment variables:

INTEGRATION_AUTH_GITLAB_CLIENT_ID=your_gitlab_client_id
INTEGRATION_AUTH_GITLAB_CLIENT_SECRET=your_gitlab_client_secret
INTEGRATION_AUTH_GITLAB_REDIRECT_URI=your_redirect_uri

Where:

• your_gitlab_client_id: The Application ID from your GitLab OAuth App
• your_gitlab_client_secret: The Secret from your GitLab OAuth App
• your_redirect_uri: The callback URL that you specified when you created the OAuth App (for example, https://your-nocodb-instance.com/)

OAuth Scopes

The GitLab integration requests these GitLab scopes:

• api: Access to the GitLab API
• read_user: Read-only access to user profile data
• read_repository: Read-only access to repository contents over HTTPS
• write_repository: Write access to repository contents over HTTPS

Availability

• App Sync is available on NocoDB Cloud (Plus plan and above) and licensed self-hosted deployments (Business plan and above). This page covers OAuth app setup for self-hosted deployments. On NocoDB Cloud, these OAuth apps are preconfigured.