Jira Integration

Create an Atlassian Cloud Developer Instance

Atlassian offers a development-specific org option, different from simply having a personal Jira organization. Even if you already have a personal Jira org, it's worth creating a development org, because it will correctly set a number of necessary options for you automatically.

Set Up ngrok

(This is only necessary if you're developing locally.) Download and set up ngrok, then start an ngrok server.

Configure Jira Settings

  1. If you don't have any projects in your Jira org yet, create a new project.
  2. In the navigation bar at the top of the screen, go to Apps > Manage Your Apps.
  3. At the bottom of the Manage Apps page, click Settings (1).
  4. Select Enable Development Mode and Enable Private Listings (2), and click Apply.

Jira Settings

  1. Reload the page, and Upload App should appear next to Build a New App.
  2. Click Upload App and upload the Atlassian Connect descriptor by using the URL  https://{YOUR_SENTRY_DOMAIN}/extensions/jira/descriptor/. Note that if you are running a local devserver, YOUR_SENTRY_DOMAIN will be your ngrok (or other tunneling service) domain.

Upload Descriptor to Jira

Follow our documentation on installing and configuring the Jira integration to use the integration.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").