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

# Jira

> A step-by-step guide to configure Jira integration for Automa

Automa supports [Jira](https://www.atlassian.com/software/jira) integration for:

* **Project Management:** Allows users to create tasks from Jira issues and update issues based on bot actions.

## Creating app

You can create a [Jira App](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/) by going to [Create > OAuth 2.0 integration](https://developer.atlassian.com/console/myapps/create-3lo-app) in Atlassian Developer Console.

<Steps>
  <Step title="Get server URL">
    Retrieve the URL for the **API** service after you [set up Automa](/self-hosting#automa).
  </Step>

  <Step title="Add scopes">
    Go to the **Permissions** tab and add the following scopes in **Jira API** category:

    * `read:jira-work`
    * `read:jira-user`
    * `write:jira-work`
    * `manage:jira-webhook`
  </Step>

  <Step title="Callback URL">
    Go to the **Authorization** tab and set the callback URL to `https://<your-api-server>/callbacks/jira`.
  </Step>

  <Step title="Copy the secrets">
    Go to the **Settings** tab and copy the required secrets:

    * Client ID
    * Client Secret
  </Step>
</Steps>

<video autoPlay muted loop playsInline className="mx-auto rounded-xl" src="https://mintcdn.com/automa/eeL4keyWWsKr0LQB/videos/self-hosting/integrations-jira.mp4?fit=max&auto=format&n=eeL4keyWWsKr0LQB&q=85&s=867ae722565fe947c99f61cbd46c756f" data-path="videos/self-hosting/integrations-jira.mp4" />

## Adding environment variables

To configure the Jira integration, you need to set the following environment variables:

* `JIRA_API_CLIENT_ID`: The client ID of your Jira App.
* `JIRA_APP_CLIENT_SECRET`: The client secret of your Jira App.

Depending on your self-hosting setup, you can configure environment variables in different ways. You can find the relevant instructions for your setup below:

<Columns cols={2}>
  <Card arrow title="Docker" icon="docker" href="/self-hosting/setup/docker#adding-environment-variables">
    Configure environment variables in Docker
  </Card>

  <Card arrow title="Railway" icon="train-track" href="/self-hosting/setup/railway#adding-environment-variables">
    Configure environment variables in Railway
  </Card>
</Columns>