Install IssueMesh
From the installation link to the first synchronized issue, without scripts or consultants.
Before you start
- Jira Cloud. IssueMesh is an Atlassian Forge app for Jira Cloud.
- A site admin installs the app.
- Your partner needs IssueMesh or IssueMesh Free on their site. If you pair two spaces of your own site, one installation is enough.
- Network. If your organization filters outgoing traffic from Atlassian apps, allow
gateway.issuemesh.com.
1. Get the installation link
IssueMesh is not on the Atlassian Marketplace yet, so installations go through an installation link. Choose the edition: IssueMesh, or IssueMesh Free if your partner runs IssueMesh. Tell us your Jira Cloud site and your partner in the contact form, and we send you the link.
2. Install and approve the permissions
Open the link as a Jira site admin, choose your site and approve the app's permissions:
| Permission | Why IssueMesh needs it |
|---|---|
| Read Jira work | read the issues, fields, statuses and comments of enabled spaces |
| Write Jira work | create and update synchronized issues, comments, attachments and links |
| Read Jira users | show people's display names (no e-mail addresses) |
| App storage | keep the organization name and the enabled spaces in the app |
| App system token | let the IssueMesh Hub act as the app's user |
| App user token | let the Hub check that a person administers the space they configure |
The app registers itself with the IssueMesh Hub - no tokens, accounts or API keys to create.
3. Complete the IssueMesh admin page
In Jira, open Jira settings (⚙) › Apps › IssueMesh (or IssueMesh Free) and follow Getting started:
- Name your organization. Your partner sees this name next to your site address. Nothing synchronizes without it.
- Enable spaces. Only enabled spaces can be paired; events of other spaces never leave your site.
4. Pair a space and choose what to share
- A space admin opens Space settings › Apps › IssueMesh, chooses New pairing and enters the partner's site address, their space key and where issues mainly originate.
- The partner's space admin accepts the request in their space settings.
- Each side opens the pairing and chooses Use recommended setup - or sets up Sending and Receiving field by field.
- If the spaces already had issues, decide about them on the Existing issues tab.
The setup checklist on each pairing always shows the next step. Synchronization of a direction starts as soon as both sides have saved their half.
Need help?
See Support, or contact us.