GitLab

Instructions for setting up GitLab authentication integration for NocoDB

This document provides instructions for setting up the GitLab authentication integration for NocoDB.

Environment Variables

To enable OAuth2 authentication with GitLab, you need to set up the following environment variables:

Step 1: Create a GitLab OAuth Application

1. Log in to your GitLab account
2. Navigate to User Settings > Applications (or for organization-wide application, go to your Group settings > Applications)
3. Fill out the form:

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

1. Click "Save application"

Step 2: Get Application ID and Secret

After creating your OAuth App, you'll be provided with:

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

Step 3: Set Environment Variables

Configure your NocoDB instance with the following 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 you specified when creating the OAuth App (e.g., https://your-nocodb-instance.com/)

OAuth Scopes

The GitLab integration requests the following 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.

Related pages

• Bitbucket : Instructions for setting up Bitbucket authentication integration for NocoDB
• GitHub : Instructions for setting up GitHub authentication integration for NocoDB
• Google Calendar : Instructions for setting up Google Calendar authentication integration for NocoDB
• Linear : Instructions for setting up Linear authentication integration for NocoDB
• Outlook Calendar : Instructions for setting up Outlook Calendar authentication integration for NocoDB