# Linear

## Learn more about Sentry's Linear integration, which streamlines issue creation and linking.

Linear is an issue tracking tool built for speed, streamlining software projects, tasks, and bug tracking. Effortlessly create new Linear issues from Sentry and link Sentry issues to existing Linear issues.

This integration is maintained and supported by the company that created it. For more details, check out our [Integration Platform documentation](/organization/integrations/integration-platform/).

## [Install and Configure](#install-and-configure)

Sentry owner, manager, or admin permissions are required to install this integration.

Linear **won't** work with self-hosted Sentry.

1. Navigate to **Settings > Integrations > Linear**

   [![Install Linear integration](/_next/image/?url=%2Fmdx-images%2Flinear-install-pg-FZSOAOPR.png%231954x1158\&w=3840\&q=75)](/mdx-images/linear-install-pg-FZSOAOPR.png)

2. Follow the full [Linear installation instructions](https://linear.app/docs/sentry).

## [Issue Management](#issue-management)

Issue tracking allows you to create Linear issues from within Sentry, and link Sentry issues to existing Linear issues. Issue management can be configured in two ways — automatically or manually.

### [Automatically](#automatically)

To configure issue management automatically, create an [issue alert](/product/alerts/alert-types/#issue-alerts) or a [metric alert](/product/alerts/alert-types/#metric-alerts). When selecting the [action](/product/alerts/create-alerts/issue-alert-config/#then-conditions-actions), choose "Notify Integration" and then "Linear" for issue alerts, or select "Linear" from the action dropdown for metric alerts:

[![Create Linear issue as metric alert rule action](/_next/image/?url=%2Fmdx-images%2Flinear-rule-HE5ARHCG.png%231232x1070\&w=3840\&q=75)](/mdx-images/linear-rule-HE5ARHCG.png)

A Linear issue will be created automatically when the alert is triggered.

### [Manually](#manually)

To configure issue management manually, navigate to a specific Sentry issue and find the "Linked Issues" section on the right panel:

[![Link Linear issue from Sentry issue](/_next/image/?url=%2Fmdx-images%2Flinear-link-issue-ODQGU54K.png%232414x876\&w=3840\&q=75)](/mdx-images/linear-link-issue-ODQGU54K.png)

Here, you’ll be able to create or link Linear issues.

[![Create Linear issue form](/_next/image/?url=%2Fmdx-images%2Flinear-create-issue-T3J57CYW.png%231714x1204\&w=3840\&q=75)](/mdx-images/linear-create-issue-T3J57CYW.png)
