mirror of
https://github.com/MODSetter/SurfSense.git
synced 2026-04-25 08:46:22 +02:00
69 lines
2 KiB
Text
69 lines
2 KiB
Text
---
|
|
title: Linear
|
|
description: Connect your Linear workspace to SurfSense
|
|
---
|
|
|
|
# Linear OAuth Integration Setup Guide
|
|
|
|
This guide walks you through setting up a Linear OAuth integration for SurfSense.
|
|
|
|
## Step 1: Access Linear API Settings
|
|
|
|
1. Navigate to your workspace's API settings at `linear.app/<your-workspace>/settings/api`
|
|
2. Under **OAuth Applications**, click **"+ New OAuth application"**
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
|
|
|
|
## Step 3: Get OAuth Credentials
|
|
|
|
After creating the application, you'll see your OAuth credentials:
|
|
|
|
1. Copy your **Client ID**
|
|
2. Copy your **Client Secret**
|
|
|
|
<Callout type="warn">
|
|
Never share your client secret publicly.
|
|
</Callout>
|
|
|
|
|
|
|
|
---
|
|
|
|
## Running SurfSense with Linear Connector
|
|
|
|
Add the Linear credentials to your `.env` file (created during [Docker installation](/docs/docker-installation)):
|
|
|
|
```bash
|
|
LINEAR_CLIENT_ID=your_linear_client_id
|
|
LINEAR_CLIENT_SECRET=your_linear_client_secret
|
|
LINEAR_REDIRECT_URI=http://localhost:8000/api/v1/auth/linear/connector/callback
|
|
```
|
|
|
|
Then restart the services:
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|