Skip to main content

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 OAuth 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!
I