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