> ## Documentation Index
> Fetch the complete documentation index at: https://hacktronai-changelog-e1a164be.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Connect Linear and configure how Hacktron creates Linear issues for security findings.

## Prerequisites

You need to be a Hacktron organization admin to manage the Linear integration.

You also need permission to authorize apps in the Linear workspace you want Hacktron to use.

## Configure Linear

<Steps>
  <Step title="Open Integrations page">
    In Hacktron, go to **Integrations** and find **Linear** under **Project
    Management Apps**.

    <img src="https://mintcdn.com/hacktronai-changelog-e1a164be/dpUdS1BJ16uy6tXP/images/linear.png?fit=max&auto=format&n=dpUdS1BJ16uy6tXP&q=85&s=92fd4bef611a8a61a0ac8130b31c7ecb" alt="Linear integration card in Hacktron" width="561" height="261" data-path="images/linear.png" />
  </Step>

  <Step title="Start the OAuth connection">
    Click **Connect**. Your browser will redirect to Linear.
  </Step>

  <Step title="Authorize Hacktron">
    Sign in to Linear if required and approve the requested access.

    <img src="https://mintcdn.com/hacktronai-changelog-e1a164be/dpUdS1BJ16uy6tXP/images/authorize.png?fit=max&auto=format&n=dpUdS1BJ16uy6tXP&q=85&s=c563800dd74a652285181e56f631dbf8" alt="Linear authorization" width="2248" height="1161" data-path="images/authorize.png" />

    <Info>
      Hacktron requests read and write access to automatically create Linear issues
      whenever a security issue is found in your repositories.
    </Info>
  </Step>

  <Step title="Return to Hacktron">
    After authorization, Hacktron redirects you back to **Integrations**.
  </Step>

  <Step title="Open Linear configuration">
    Click the settings icon on the Linear card.
  </Step>

  <Step title="Choose a default destination">
    Select the default Linear team. Optionally, choose a default Linear project.

    <Warning>
      Linear shows **Setup required** until a default team is saved.
    </Warning>

    Enable **Automatically create tickets** for Hacktron to automatically create Linear issues for every
    security finding. If this is not enabled, you can still create Linear issues manually from the finding detail view.

    <img src="https://mintcdn.com/hacktronai-changelog-e1a164be/dpUdS1BJ16uy6tXP/images/linear_config.png?fit=max&auto=format&n=dpUdS1BJ16uy6tXP&q=85&s=6963982c7140c64e2c628253d0c70550" alt="Linear settings" width="752" height="813" data-path="images/linear_config.png" />
  </Step>

  <Step title="Backfill existing findings (optional)">
    Use **Backfill existing findings** to create Linear tickets for approved findings that were created before the integration was configured.

    Click **Backfill now** to start the process.
  </Step>

  <Step title="Save settings">
    Click **Save** to apply the Linear configuration.
  </Step>
</Steps>

## Using Linear tickets

After Linear is connected and configured, open an approved finding and choose **Create on Linear** to create a Linear issue manually. If the finding already has a Linear issue, Hacktron shows **View on Linear** instead.

## Common checks

* If Linear shows **Setup required**, open settings and save a default team.
* If backfill is unavailable, confirm that a default team has been saved.
* If a ticket already exists for a finding, use **View on Linear** instead of creating another ticket.