> For the complete documentation index, see [llms.txt](https://docs.spike.sh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spike.sh/collaboration/task-management-integrations/jira-server-self-hosted.md).

# JIRA server (self-hosted)

Connect Spike to a self-hosted Jira server using OAuth credentials to create tickets directly from your incidents.

To connect, you need three things from your Jira server:

* **Base URL** (the domain where your server is hosted, e.g. `https://jira.mydomain.com`)
* **Client ID**
* **Client Secret**

## Generate credentials on Jira

1. On your Jira server, go to **Settings > Applications**
2. Click **Application Links**
3. Click **Create Link**

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-82b728df9a57b6ca6d90a3e3a1f9b5714a456735%2Fimage.png?alt=media" alt="Application Links in Jira server settings"><figcaption><p>Application Links in Jira server settings.</p></figcaption></figure>

4. On the Create Link modal, select **External application** and **Incoming**

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-d13355a3959642e87910ae68393a757b0fe7cca5%2Fjira-server-spike-2.png?alt=media" alt="Create Link modal in Jira"><figcaption><p>Select External application and Incoming.</p></figcaption></figure>

5. Fill in the details:
   * **Name**: Spike
   * **Callback URL**: `https://app.spike.sh/task-management/jira/self-hosted/auth/callback`
   * **Permission**: Write
   * Click **Save**

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-44a2c0d317ee99fa2179d261692e42abd9bd5e23%2Fjira-server-integration-form.png?alt=media" alt="Jira application link details form"><figcaption><p>Fill in the application link details.</p></figcaption></figure>

6. Copy the generated **Client ID** and **Client Secret**
7. Your **Base URL** is the domain where Jira is hosted, e.g. `https://jira.spike.sh`. Do not include a trailing slash.

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-f2594fbe4aeb8c6a8478f05c3a2fa29d91d6e8bf%2Fjira-integration-final-step.png?alt=media" alt="Generated Client ID and Client Secret in Jira"><figcaption><p>Copy the Client ID and Client Secret.</p></figcaption></figure>

## Connect in Spike

Go to [Settings > Organisation](https://app.spike.sh/settings/general/organisation#org--task-management) and select **JIRA server**. Enter the Base URL, Client ID, and Client Secret. Then click **Connect**.

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-514fb64e15d3cb70128e4d652d29c28cfdf1d905%2Fimage%20(1).png?alt=media" alt="Jira server connection form in Spike settings"><figcaption><p>Enter your Jira server credentials in Spike settings.</p></figcaption></figure>

Jira opens for validation. Grant the requested permissions to complete the connection.