[Other doc versions]
Atlassian JIRA's support for Stash is built into the FishEye 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 plugin in JIRA to get support for Atlassian Stash.
|JIRA Version||Compatibility||FishEye plugin URL|
|5.0.4+||Works straight out of the box!||NA|
|5.0-5.0.3||Requires JIRA FishEye Plugin 22.214.171.124||https://maven.atlassian.com/content/repositories/atlassian-contrib/com/atlassian/jira/plugins/jira-fisheye-plugin/126.96.36.199/jira-fisheye-plugin-188.8.131.52.jar|
|4.4.x||Requires JIRA FishEye 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 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|
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 Plugin in JIRA 4.3 for more details.
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.