Linear OAuth Integration Setup Guide

This guide walks you through setting up a Linear OAuth integration for SurfSense.

Step 1: Access Linear API Settings

Navigate to your workspace's API settings at linear.app/<your-workspace>/settings/api
Under OAuth Applications, click "+ New OAuth application"

Linear API Settings Page

Step 2: Create New Application

Fill in the application details:

Field	Value
Application icon	Upload an icon (at least 256x256px)
Application name	`SurfSense`
Developer name	`SurfSense`
Developer URL	`https://www.surfsense.com/`
Description	Connect any LLM to your internal knowledge sources and chat with it in real time alongside your team.
Callback URLs	`http://localhost:8000/api/v1/auth/linear/connector/callback`
GitHub username	Your GitHub username (optional)

Settings

✅ Public - Enable this to allow the application to be installed by other workspaces

Click Create to create the application.

Create New Application Form

Step 3: Get OAuth Credentials

After creating the application, you'll see your OAuth credentials:

Copy your Client ID
Copy your Client Secret

⚠️ Never share your client secret publicly.

OAuth Credentials

Running SurfSense with Linear Connector

Add the Linear environment variables to your Docker run command:

docker run -d -p 3000:3000 -p 8000:8000 \
  -v surfsense-data:/data \
  # Linear Connector
  -e LINEAR_CLIENT_ID=your_linear_client_id \
  -e LINEAR_CLIENT_SECRET=your_linear_client_secret \
  -e LINEAR_REDIRECT_URI=http://localhost:8000/api/v1/auth/linear/connector/callback \
  --name surfsense \
  --restart unless-stopped \
  ghcr.io/modsetter/surfsense:latest