---
title: "Installation and Upgrade"
canonical: "https://support.appfire.com/space/ILV/198247881/Installation%20and%20Upgrade"
format: markdown
---
> Macro (aura-html)

**Related pages:**

- [Supported Platforms](https://appfire.atlassian.net/wiki/spaces/ILV/pages/198117721)

## Install Issue Matrix for Jira 

### Install on Jira Data Center

To install the Issue Matrix for Jira app on your **Jira Data Center** instance, follow these steps:

1. Log into your Jira Data Center instance as a user with the **Jira System Administrator** [global permission](https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html).
2. Click the **cog icon** on the top bar and select **Manage apps**.
3. From the left-hand side menu, click **Find new apps**.
4. Search for **Issue Matrix for Jira**.
5. Once you locate the app, click the **Buy now button**.
6. Review the app details and click **Select & install** to proceed with the installation.
7. After the installation is complete, you may need to provide your Issue Matrix app's license key in the **License key** textbox. You can copy your license key from <u>[https://my.atlassian.com](https://my.atlassian.com/)</u>

![image](media://495b8b94-a9d7-4035-9907-d03c496a446a)

### Install on Jira Server

To install the Issue Matrix for Jira app on your **Jira Server** instance, follow these steps:

1. Visit Issue Matrix for Jira’s [Atlassian Marketplace](https://marketplace.atlassian.com/apps/1211611/configuration-manager-for-jira-cmj?hosting=server&tab=overview) page.
2. From the *Hosting options* dropdown on the right side of the page, select **Server** as the hosting type.
3. Scroll to the **Resources** section at the bottom of the page and click **Download** to get the Issue Matrix installation file.
4. In your Jira Server instance, log in as a user with the **Jira System Administrator **[global permission](https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html).
5. Click the **cog icon** on the top bar and select **Manage apps**.
6. From the left-hand side menu, click **Manage apps**.
7. Click the **Upload app** link and select the installation file you downloaded in step 3.
8. Click **Upload** and wait for the app to install.
9. After the installation is complete, select **Close** in the *Installed and ready to go* dialog. You may need to provide your Issue Matrix app's license key in the **License key** textbox. You can copy your license key from <u>[https://my.atlassian.com](https://my.atlassian.com/)</u>

## Verify the installation

Issue Matrix** **is implemented as a custom field. To verify that it has been successfully installed, you should see it in the list of custom fields. Navigate to the Admin section of the user interface, go to sub-menu *Issues*, and choose the *Custom Fields* page.

Click on the **+ Add Custom Field** button, which will open a pop-up window. In the window, select the **All** section on the left and either browse or search for Issue Matrix.

![image](media://a9097d45-93b7-4ed3-8410-144f4ac2adc5)

## Update Issue Matrix for Jira

The easiest way to update** **Issue Matrix is through the **Manage App** section in the Jira Admin section of the user interface. Just click the **Update** button, and Jira will take care of the rest.

![image](media://b156dfab-3a99-404f-89e7-18c92f36679d)

## Uninstall Issue Matrix for Jira

To uninstall the Issue Matrix for Jira app, follow these steps:

1. Log in as a user with the **Jira System Administrator** [global permission](https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html).
2. Click the **cog icon** on the top bar and select **Manage apps**.
3. On the *Manage Apps* page, locate **Issue Matrix for Jira** in *User-installed apps*. Click on it to display its details.
4. Click the **Uninstall** button.

![issue-matrix-uninstall.png](media://ff0de6a6-c0b4-4962-9bb5-3de3e6b8abf0)