> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airys.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up Linear Integration

> Configure Linear integration to track issues and features from AirysChat

Setting up AirysChat Linear integration involves 5 steps.

1. Create a Linear app in the [developer portal](https://linear.app/settings/api/applications/new).
2. Add necessary details and save the app.
3. Configure AirysChat with the `Client ID` and `Signing Secret` obtained from the Linear app.
4. Open AirysChat UI, navigate to integrations, select Linear, and click connect.
5. Voila! You should now be able to use Linear in your AirysChat account.

## Register and configure the Linear app

To use Linear Integration, you need to create a Linear app in the developer portal. You can find more details about creating Linear apps at the [Linear developer portal](https://developers.linear.app/docs/oauth/authentication).

1. Create a Linear app.
2. Obtain the `Client ID` and `Client Secret` for the app and configure it in your app config via `{AirysChat installation url}/super_admin/app_config?config=linear`
3. The callback URL should be `{AirysChat installation url}/linear/callback`.
4. Toggle the `Public` switch to make the app public.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/linear/create-app.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=467ffdfea36518aeac3e2f589e1e32aa" alt="linear_app_domain" width="1410" height="1368" data-path="self-hosted/images/linear/create-app.png" />

## Configure Linear app config

Obtain the `Client ID` and `Client Secret` for the app and configure it in your app config via `{AirysChat installation url}/super_admin/app_config?config=linear`. These values will be available when you create the app in the developer portal.

```bash theme={null}
LINEAR_CLIENT_ID=
LINEAR_SIGNING_SECRET=
```

Restart the AirysChat server.

<Note>
  Linear will only show up in the integrations section once you have configured these values and restarted the server.
</Note>

## Connect AirysChat with your Linear account

Follow this [guide](https://airyschat.help/hc/user-guide/articles/1739949089-how-to-track-issues-and-features-with-linear-integration) to complete the Linear integration.