[Other doc versions]
Atlassian JIRA's support for Stash is built into the FishEye/Stash plugin that is bundled with JIRA. This allows you to see all of your code changes in one place, even if you're running multiple Atlassian FishEye and Stash servers.
If you're using a version of JIRA earlier than 5.0.3 you may need to upgrade the FishEye/Stash plugin in JIRA to get support for Atlassian Stash.
|JIRA Version||Compatibility||FishEye/Stash plugin URL|
|5.0.4+||Works straight out of the box!||NA|
|5.0-5.0.3||Requires JIRA FishEye Plugin 188.8.131.52||https://maven.atlassian.com/content/repositories/atlassian-contrib/com/atlassian/jira/plugins/jira-fisheye-plugin/184.108.40.206/jira-fisheye-plugin-220.127.116.11.jar|
|Limited support for JIRA 4.4.x and earlier|
|JIRA 4.3+ allows for showing commits associated with issues in JIRA. However, viewing issues within Stash is not supported for JIRA 4.4.x and earlier.|
|4.4.x||Requires JIRA FishEye/Stash Plugin 3.4.12||https://maven.atlassian.com/content/repositories/atlassian-contrib/com/atlassian/jira/plugins/jira-fisheye-plugin/3.4.12/jira-fisheye-plugin-3.4.12.jar|
|4.3.x||Requires JIRA FishEye/Stash Plugin 3.1.8||https://maven.atlassian.com/contrib/com/atlassian/jira/plugins/jira-fisheye-plugin/3.1.8/jira-fisheye-plugin-3.1.8.jar|
|Earlier versions||JIRA-to-Stash integration is unsupported||NA|
The display of details for JIRA issues relies on the JIRA 5.0 REST API. Issue details are not displayed when Stash in integrated with JIRA versions earlier than 5.0.
To upgrade the plugin, copy the link from the table above that matches your JIRA version. Then navigate in JIRA to Administration > Plugins.
Next, select the Install Plugins tab and click Upload Plugin.
Now paste the URL copied from the table above into the From this URL field, and click Upload.
You should see that the plugin is installed. Now you can continue integrating Atlassian Stash with your JIRA server. See JIRA integration for details.
JIRA 4.3.x Upgrade Note
When upgrading the plugin in JIRA 4.3.x you may see a "zip file closed" error message in the logs. This can be ignored. See "IllegalStateException: zip file closed" when upgrading JIRA FishEye/Stash Plugin in JIRA 4.3 for more details.