Linear Connector - Negere-Fej Documentation

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 + Negere-Fej env variables

This is only necessary if self-hosting Negere-Fej. If using Negere-Fej 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 Negere-Fej. The application callback URLs should include <your negere-fej 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 Negere-Fej instance using the Client ID and Signing Secret provided by Linear for your new app:

LINEAR_CLIENT_ID=
LINEAR_CLIENT_SECRET=

3. Restart Negere-Fej

Restart your Negere-Fej instance as you normally would to apply the changes.

Indexing

1. Open Linear connector

In the Negere-Fej 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 Negere-Fej

Once you've authorized the application, you'll be redirected back to Negere-Fej.

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!