# Stash Latest : JIRA integration

This page last changed on Sep 03, 2012 by pwatson.adm.

When Stash is integrated with Atlassian JIRA, you can: See the JIRA issues related to particular commits in Stash, as shown in the screenshot below of the Commits tab for a Stash project. Click through to the issues in JIRA. Use JIRA for delegated user management. See External user directories. Stash integrates with JIRA by means of an 'application link'. You can set up application links either during the Stash install process, or as described below.
| Stash integration with JIRA requires an upgraded version of the FishEye plugin in JIRA. See JIRA compatibility for details about upgrading the JIRA FishEye plugin, and for download links to the upgraded plugin versions.
| On this page: Linking Stash with JIRA Known issues with the JIRA integration Related pages: Installing Stash on Windows Installing Stash on Linux and Mac Configuring Application Links Connecting to JIRA for user management

## Linking Stash with JIRA

To link Stash to a JIRA server:

Go to the Configure Application Links screen in Stash:

Click Add Application Link:

Complete the application link wizard to connect Stash to your JIRA server. It is recommended that you make use of the automatic link-back from JIRA to Stash.

More detailed information about application links can be found on Configuring Application Links.

You're finished! No other configuration is required. The next time a commit is pushed to a Stash repository, Stash will index all previous commits to that repo and link them to the corresponding JIRA issues. Your JIRA issues will then appear in the changesets and commit lists in Stash. On the JIRA side, the commits associated with a specific issue will now appear in the issue's Source tab.

| Where are my issues? To avoid overloading your server, Stash will trigger issue key indexing for a particular repository on the first push to that repository after you have created a JIRA Application Link. So if you aren't seeing JIRA issue keys showing up in your "Issues" column, try pushing a small change to the repository and refreshing the page.

## Known issues with the JIRA integration

We have tried to make the integration of JIRA with Stash as straightforward as possible. However, we are aware of the following issues:

- Stash only supports one JIRA server; we only pick the primary one.
- There is no checking for project or issue-key validity; Stash may link to issues that do not actually exist.

We apologise for the inconvenience. You can watch the 2 issues below to keep track of our progress:

- STASH-2471 - Authenticate to see issue details
- STASH-2470 - Authenticate to see issue details

## Attachments:

skitched-20120316-150747.jpg (image/jpeg)
skitched-20120327-161202.jpg (image/jpeg)
image2012-3-27 16:58:27.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:21:32.png (image/png)
image2012-3-27 17:21:32.png (image/png)
STASH10_JIRAs in commits.png (image/png)
Stash_1_1_add_application_link.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_add_application_link.png (image/png)
STASH10_JIRAs in commits.png (image/png)
image2012-3-27 17:21:32.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 16:58:27.png (image/png)
skitched-20120327-161202.jpg (image/jpeg)
skitched-20120316-150747.jpg (image/jpeg)
Stash12_app_link.png (image/png)
Stash12_add_app_link.png (image/png)