> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/on-prem-setup/jira-on-prem.md).

# Jira On-Prem

### Creating a Personal Access Token (PAT) in Jira

To integrate **Hivel** with **Jira**, you need to generate a **Personal Access Token (PAT)** for authentication. Below are the detailed steps for setting up the **service account** and generating the PAT in **Jira** for successful integration:

#### **Prerequisites**

* **Jira Service Account**: Ensure you have a **service account** with **Site Admin** access to the Jira projects you want to analyze. This account will be used to fetch data from Jira for Hivel analysis.

***

#### **Steps for Integration**

**1. Service Account Setup**

* **Create a service account** in Jira if you don’t already have one.
* Ensure this service account has **Site Admin access** to the required Jira projects you want Hivel to analyze.
* The service account must have sufficient permissions to read data from the Jira projects, such as issue fields, access to all boards, and any other necessary information for analysis.

**2. Generate Personal Access Token (PAT)**

To authenticate Hivel with Jira, you’ll need to generate a Personal Access Token (PAT). Follow these steps:

* **Step 1**: Log in to your **Jira Service Account** and go to the following URL to manage your account settings:\
  [<mark style="color:purple;">Jira Account API Tokens</mark>](https://id.atlassian.com/manage-profile/security/api-tokens)
* **Step 2**: On the **API Tokens** page, click on **Create API token**.
* **Step 3**: In the **Create API token** dialog:
  * Enter a **label** for the token (e.g., "Hivel Integration").
  * Click **Create** to generate the token.
* **Step 4**: After the token is created, a new token will appear in the list. Click the **Copy** button to copy the token to your clipboard.
* **Step 5**: Store this token securely, as it is the only time it will be shown. You will use this token to authenticate with Jira from Hivel.

Use the token to complete the next steps as shown on the Integration screen in Hivel.