[Other doc versions]
[Doc downloads (PDF, HTML, XML)]
See JIRA integration for a description of all the integrations you get when Stash is linked with JIRA.
You can also use JIRA for delegated user management. See External user directories.
This page describes how to link Stash to JIRA.
You can integrate Stash with one or more instances of JIRA by means of 'application links'. You set up application links either:
Note that integrating Stash with JIRA may require an upgraded version of the FishEye/Stash plugin in JIRA. See JIRA FishEye-Stash Plugin compatibility for details about upgrading the JIRA FishEye/Stash plugin, and for download links to the upgraded plugin versions.
To link Stash to a JIRA server:
You're finished! Your JIRA issues will 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. Note that Stash only begins scanning commit messages for JIRA issue keys on the first push after you created the application link to JIRA – the scan may take a short time.
More detailed information about application links can be found on Configuring Application Links.
We have tried to make the integration of JIRA with Stash as straightforward as possible. However, we are aware of the following issue:
We apologise for the inconvenience. Please watch the issue to keep track of our progress.
There are a few scenarios where the integration of Stash with JIRA can produce an error:
This can result if authentication for the application link has not been set up. See Troubleshooting JIRA Integration.
If you don't have permission to access the JIRA project then Stash is unable to display issues.
Stash can integrate with JIRA 4.3.x, or later. Some features require higher versions of JIRA to function properly. See Integrating Stash with Atlassian applications for details.
Stash doesn't check for invalid issue keys, such as UTF-8. An error will result if Stash tries to connect to an issue that doesn't exist.
Stash assumes that JIRA issue keys are of the default format (that is, two or more uppercase letters (
[A-Z][A-Z]+), followed by a hyphen and the issue number, for example STASH-123). By default, Stash will not recognise custom JIRA issue key formats. See Using custom JIRA issue keys with Stash for details.
Stash allows a user with global permissions of "Administrator" to create an OAuth only application link. You need to log in with a user having "System Administrator" privileges to create an application link using Trusted Applications.