# Jira Server v2.0

<figure><img src="https://2853711081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhHYdqf09DtGwAq3Pa3FU%2Fuploads%2Fgit-blob-5bcf71dc1d5444d3b48239e8df41f6c72d0bc51e%2FPremium.svg?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Due to Atlassian's decision to deprecate its server products, the Jira server v2.0 app is no longer supported in the latest versions of Rocket.Chat and will be ![](https://2853711081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhHYdqf09DtGwAq3Pa3FU%2Fuploads%2Fgit-blob-03f1bdf5b75241c796a823ae3fb5db9f007380fc%2FDeprecated%20\(1\).png?alt=media)
{% endhint %}

## Features

This app lets you connect your channels or private groups to different projects from different Jira Servers.

The following notifications are supported:

* Project created
* Project deleted
* Issue created
* Issue transitioned
* Issue updated

## Installation

{% hint style="warning" %}
**Migrating from version 1.x:** Please note that this is a *major* version update, which means it includes breaking changes. You *will need* to configure your connections again after the update.
{% endhint %}

You can install our Jira Server Integration Rocket.Chat App from your Rocket.Chat Administration area.

* Go to **Administration > Workspace > Marketplace**
* Search for the **Jira Server Integration** and click on the item
* Click on the **Install** button
* Click on **Activate**

Now that you have the app installed in your server, it is time to configure the integration with your Jira instance.

## Configuration

Go to any channel or private group and execute the slashcommand `/jira-server`. You will be prompted with the *Room Preferences* dialog\_:\_

![Room Preferences dialog](https://2853711081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhHYdqf09DtGwAq3Pa3FU%2Fuploads%2Fgit-blob-22c3d64da347145034baac182e1bd20a7ba9f766%2Fimage%20\(314\).png?alt=media)

Here you can connect your channel or private group to different Jira Servers. The server list is currently empty as this is a fresh install, so let's connect to a new Jira Server

### Connecting to Jira Servers

To add a new Jira Server connection from the *Room Preferences* dialog, click on the "Connect to another Jira Server" button. You will be prompted with a form to fill in the details for the connection:

![New Jira Server form](https://2853711081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhHYdqf09DtGwAq3Pa3FU%2Fuploads%2Fgit-blob-4bbeadff7465b46cea718a5bb828093312c4b2fc%2Fimage%20\(1072\).png?alt=media)

> **Note**: We advise against using your own Jira user in the installation process. That is because the Rocket.Chat App has to persist the credentials to be able to search for projects and issues later on. We recommend creating a new user with administrative privileges. After the installation process, you can revoke those privileges from the user.

After successfully connecting to the server (the app will let you know if anything goes wrong), just select the new server from the list to integrate it with your channel/private group.

![Select the new server to integrate with it](https://2853711081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhHYdqf09DtGwAq3Pa3FU%2Fuploads%2Fgit-blob-10f1ba94372fda7cc639c13cf5094dedddb115fa%2Fimage%20\(1127\).png?alt=media)

Hit "Save" and you're good to go!

Now we have to subscribe your channel to specific projects, so it starts receiving notifications from Jira.

### Subscribing to Jira Projects

Go to the channel/private group that you want to receive notifications on and run the Jira slash command `/jira-server`. You will be prompted with the *Room Integration* dialog:

![Room Integration dialog](https://2853711081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhHYdqf09DtGwAq3Pa3FU%2Fuploads%2Fgit-blob-96d2a631139b467b931e2cfe68555917b520af7a%2Fimage%20\(902\).png?alt=media)

You can click the "Subscribe" button to subscribe to any project you wish.

### Managing your Integration

If you want to manage your channel/private group integration, you can use the menu in the *Room Integration* dialog to do so:

![Room Integration dialog menu](https://2853711081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhHYdqf09DtGwAq3Pa3FU%2Fuploads%2Fgit-blob-58678e680181326f10b053ad4b36a35fc9b43d97%2Fimage%20\(84\).png?alt=media)

* **Manage Connections** - Takes you to the [*Room Preferences* dialog above](#configuration). From there you can manage to which servers your channel/private group is connected, add new servers, etc.
* **Reset Connections** - Will reset all connected servers and projects from this room. Use this if you no longer want to receive notifications on your channel/private group.
