# Linear

Access issues and projects from 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 + Quor env variables

<Info>
  This is only necessary if self-hosting Quor. If using [Quor Cloud](https://cloud.quor.app), you can skip this step.
</Info>

<Steps>
  <Step title="Create Linear application">
    [Create a Linear OAuth Application.](https://linear.app/settings/api)
    This step must be completed by an admin of the Linear workspace you wish to connect to Quor.
    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`.
  </Step>

  <Step title="Set environment variables">
    Set the following environment variables on your Quor instance using the Client ID and Signing Secret provided by
    Linear for your new app:

```bash
LINEAR_CLIENT_ID=
LINEAR_CLIENT_SECRET=
```
  </Step>

  <Step title="Restart Quor">
    Restart your Quor instance as you normally would to apply the changes.
  </Step>
</Steps>

### Indexing

<Steps>
  <Step title="Open Linear connector">
    In the Quor UI, navigate to the Admin Panel and select the **Linear** Connector
  </Step>

  <Step title="Authorize via OAuth">
    Click the `Create New` button to go through the OAuth flow.
  </Step>

  <Step title="Return to Quor">
    Once you've authorized the application, you'll be redirected back to Quor.
  </Step>

  <Step title="Select credential and configure">
    Select the new credential and click Continue. Enter connector name and permissions information.
  </Step>

  <Step title="Create connector">
    Click `Create Connector` to begin indexing Linear issues and comments!
  </Step>
</Steps>