Linear

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

Environment Variables

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

Step 1: Create a Linear OAuth App

1. Log in to your Linear account.
2. Go to Settings > API > OAuth applications (or go directly to https://linear.app/settings/api/applications).
3. Click "New OAuth application".
4. Fill in the form:

• Application Name: Your application name (for example, "NocoDB")
• Developer Name: The person or company that develops this application (for example, "NocoDB")
• Developer URL: The homepage or documentation for your application (for example, "https://nocodb.com/")
• Description: A short description of your application
• Callback URIs: The URL where Linear sends users after authorization (for example, https://your-nocodb-instance.com/)
• Enable “Public”: Turn ON to let all Linear workspaces authorize
• Icon: (Optional) Upload an icon for your application

5. Click "Create".

Step 2: Get Client ID and Client Secret

After you create your OAuth application:

1. Linear shows the Client ID and Client Secret.
2. Copy these values. You need them for the configuration.

Step 3: Set Environment Variables

Configure your NocoDB instance with these environment variables:

INTEGRATION_AUTH_LINEAR_CLIENT_ID=your_linear_client_id
INTEGRATION_AUTH_LINEAR_CLIENT_SECRET=your_linear_client_secret
INTEGRATION_AUTH_LINEAR_REDIRECT_URI=your_redirect_uri

Where:

• your_linear_client_id: The Client ID from your Linear OAuth App
• your_linear_client_secret: The Client Secret from your Linear OAuth App
• your_redirect_uri: The redirect URI that you specified when you created the OAuth App (for example, https://your-nocodb-instance.com/api/v1/integrations/auth/linear/callback)

API Key Authentication

If you use API Key authentication, not OAuth:

1. Log in to your Linear account.
2. Go to Settings > API > Personal API keys (or go directly to https://linear.app/settings/api).
3. Under "Personal API keys", type a name for your key.
4. Click "Create key".
5. Copy the generated API key. You cannot see it again.

When you configure the integration with the API Key authentication method, give this API key.

OAuth Scopes

The Linear integration requests these Linear scopes:

• read: Read access to workspace data
• write: Write access to workspace data

These scopes let the integration read and change issues, projects, and other data in your Linear workspace.

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.