Linking Fisheye to Jira

Jira Software is Atlassian's issue-tracking and project-management application. You can connect Fisheye to Jira Software for one or both of the following:

Configuring those two aspects are separate processes, and are described on this page. Note that you can link Fisheye with one or more instances of Jira Software. If you're linking Fisheye to an Atlassian Cloud Jira instance, please see Link to server applications from Cloud.

On this page:

Your user tiers don't need to match between Jira Software and Fisheye/Crucible in order to integrate them. Jira Software users that are not Fisheye users will see the same view as Fisheye users within Jira Software, but will not be able to log in to Fisheye to view the source/reviews.

Quick setup with the Fisheye Setup Wizard

When you are installing Fisheye, the setup wizard allows you to configure the Jira connection automatically. This is a quick way of setting up your integration with Jira for user management. See Configuring Jira integration in the Setup Wizard.

If you did not set up Jira integration during Fisheye setup at install time, you can still configure that from the Fisheye administration area as described below.

Integrate with Jira Software

See Jira Integration in Fisheye for an overview of the benefits you get when Fisheye and Jira are integrated.

See Linking to another application for details about linking Fisheye and Jira servers to get those integration benefits.

See also Enabling Smart Commits.

Use Jira Software to manage Fisheye users

See Connecting to Jira for user management.

We do not recommend the use of project links with Fisheye 2.9 and later, if you have Jira 5.0 or later as well as the latest version of the Jira Fisheye Plugin. This is because application links now provide all of the functionality previously available with project links. However, project links are retained for the following reasons:

  • Setting up project links provides a way to restrict the scope of Jira searches to a specific Fisheye repository. 
  • Legacy configurations can continue to use project links without any need for changes.
  • Third-party plugins may continue to rely on project links for their functionality.


  • Jira requires manual refresh of the Fisheye repository cache when repository changes are made — When a repository is removed, or when there has been any change in Fisheye repositories, Jira does not update the Fisheye repository list cache automatically. You must manually refresh the repository list cache. This is done in Jira: go to Administration > Fisheye Configuration and click Refresh Cache (next to 'Repository List Cache').
  • Fisheye doesn't check for invalid Jira issue keys – Fisheye doesn't check for invalid issue keys, such as 'UTF-8'. An error will result if Fisheye tries to connect to an issue that doesn't exist.
  • Fisheye doesn't recognize custom Jira issue key formats – Fisheye assumes that Jira issue keys are of the default format for Jira 5.0 and later: that is, between 2 and 10 characters long and contain only uppercase letters followed by a hyphen and the issue number, for example, FECRU-123.  The regex describing this pattern: [A-Z]{2,10}-[0-9]+
  • If Fisheye/Crucible will be running on the same machine as Jira (already installed), you need to ensure that the URL paths are different for Fisheye/Crucible and Jira Software. Change the default Fisheye/Crucible path as follows:
    • Edit the config.xml in your Fisheye/Crucible data directory.
      Add the context attribute to the web-server  element:

      <web-server context="/fisheye">
Last modified on Dec 13, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.