Linear

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 + Nexus env variables#

Complete the provider setup unless your school operator confirms that the required OAuth application is already configured.

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 Nexus. 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.

Set environment variables#

Set the following environment variables on your Nexus instance using the Client ID and Signing Secret provided by Linear for your new app:

  LINEAR_CLIENT_ID=
  LINEAR_CLIENT_SECRET=

Restart Nexus#

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

Indexing#

Open Linear connector#

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

Authorize via OAuth#

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

Return to Nexus#

Once you've authorized the application, you'll be redirected back to Nexus.

Select credential and configure#

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

Create connector#

Click Create Connector to begin indexing Linear issues and comments!

Before using this source with students#

Start with approved course material. Check which documents the connector can retrieve and how it maps source permissions. Test with a student account and a teacher account before widening access. A successful sync does not prove that the intended class boundary is correct.

Use source troubleshooting when a document is missing or visible to the wrong audience.