# Installing plugin for Jira Cloud

You can install the **aqua4Jira** plugin in two ways:

**Option 1: From the Atlassian Marketplace**

* Go to [Atlassian Marketplace](https://marketplace.atlassian.com/)
* Search for **aqua4jira**

<figure><img src="/files/o80OBhsjyOAukNeckZTQ" alt=""><figcaption></figcaption></figure>

* Click **Get it now** and select the instance for which you want to install plugin if you have many of them.

<figure><img src="/files/7bkGNWMJh9lOivK6iHJ7" alt=""><figcaption></figcaption></figure>

* Follow the instructions to complete the installation. It only takes a few minutes!

**Option 2: From your Jira instance**

* Open your Jira Cloud instance
* Open **Settings** in the top menu

<figure><img src="/files/Dzjfks9WQWQFoS9CskRX" alt=""><figcaption></figcaption></figure>

* Click **Apps**

<figure><img src="/files/K4uTUYCDAv4DzgbWwgb4" alt=""><figcaption></figcaption></figure>

* Once you land on the Apps page, click **Explore apps**

<figure><img src="/files/TRdtz7hJv2qVVSlxgmjG" alt=""><figcaption></figcaption></figure>

* Then search for **aqua4jira**

<figure><img src="/files/5EH80RgufQkczpSCJNUN" alt=""><figcaption></figcaption></figure>

* When you are on aqua4jira page, click on the 'Get it now' button.

<figure><img src="/files/zCtRqyAu2fo000nsvr8Q" alt=""><figcaption></figcaption></figure>

Then select the site for which you want to install it and click the **Review** button.

<figure><img src="/files/xYeIFTukGg0X6f3bgrTb" alt=""><figcaption></figcaption></figure>

In a few seconds it will be installed and you need to click **Manage** app on the toast message that appears once plugin is ready.

<figure><img src="/files/aG5ZjZC891c6iq9gQiCw" alt=""><figcaption></figcaption></figure>

You will be navigated to the Apps page where you need to select **aqua Configuration** on the sidebar.

<figure><img src="/files/cOxeBSLbvQh8gWHGFJQx" alt=""><figcaption></figcaption></figure>

### **aqua pre-requisites**

To connect the plugin, you need to create a **technical user** in aqua and assign them the **Jira plugin license**.

This license is included with every paid aqua subscription by default, at no extra cost.

Creating a technical user works the same way as adding any other user in aqua.\
For step-by-step instructions, check out our guide: [*How to add a new user*.](/documentation/user-administration/adding-and-editing-user-profile.md#adding-user)

Once a user is created, you need to assign all projects from which you'd like to link test cases and test scenarios (suites). Since technical user doesn't modify any items, a role with read-only permissions will suffice.

### **Configuring plugin in Jira**

At the configuration page, you need to provide:

* the base URL of your aqua site
* username of your technical user (The plugin requires a user who is not already present in aqua, unless it’s the Jira sync user)
* password of your technical user

<figure><img src="/files/WAgv9dnslN3S034KDHWp" alt=""><figcaption></figcaption></figure>

You can click to test connection to verify if everything has been filled out correctly.

<figure><img src="/files/N7l0iClagcnnKW4LZVaZ" alt=""><figcaption></figcaption></figure>

Next, choose whether you want to enable test cases, test scenarios, or both.

You can also restrict access to specific Jira projects if needed.

Once you've set your preferences, click **Save** to apply the configuration.

The plugin is ready to be used.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/integrations/aqua4jira-plugin-cover-jira-issue-with-aqua-test-cases/installing-plugin-for-jira-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
