​
How it works

The Linear connector pulls in all the Linear issues and the associated comments. Issues are updated every 10 minutes.

​
Setup

​
Configure your Linear Application + Onyx env variables

This is only necessary if self-hosting Onyx. If using Onyx Cloud, you can skip this step.
1

Create Linear application

Create a Linear Application. This step must be completed by an admin of the Linear workspace you wish to connect to Onyx. The application callback URLs should include <your onyx host>/connector/oauth/callback/linear. For example, for a local deployment with default configurations one of the lines should be http://localhost:3000/connector/oauth/callback/linear.
2

Set environment variables

Set the following environment variables on your Onyx instance using the Client ID and Signing Secret provided by Linear for your new app:
LINEAR_CLIENT_ID=
LINEAR_CLIENT_SECRET=
3

Restart Onyx

Restart your Onyx instance as you normally would to apply the changes.

​
Indexing

1

Open Linear connector

In the Onyx UI, navigate to the Admin Panel and select the Linear Connector
2

Authorize via OAuth

Click the Create New button to go through the OAuth flow.
3

Return to Onyx

Once you’ve authorized the application, you’ll be redirected back to Onyx.
4

Select credential and configure

Select the new credential and click Continue. Enter connector name and permissions information.
5

Create connector

Click Create Connector to begin indexing Linear issues and comments!