ℹ️ Preview feature: Jira OAuth 2.0 connections are currently in closed beta. Contact us from within the Gearset app to learn more.
ℹ️ Are you reading the right guide?
For Jira on atlassian.net
Or for legacy connections see Integrating with Jira (Hosted/Cloud using legacy OAuth 1.0a)
For self-hosted Jira
See Integrating with Jira Data Center (this page)
Or for legacy connections see Connecting to an on-premise version of Jira (legacy OAuth 1.0a connections)
Gearset integrates with Jira Data Center so that deployment updates are automatically posted to your Jira tickets. This guide covers connecting your self-hosted Jira Data Center instance to Gearset using OAuth 2.0.
Connecting Jira Data Center is a two-step process: first your Jira administrator creates an incoming link on the Data Center instance, then your Gearset team owner enters those details in Gearset.
Step 1: Create an incoming link in Jira Data Center
A Jira administrator needs to create an incoming link so that Gearset can connect to your Data Center instance. This generates the client ID and client secret that Gearset needs.
In Jira Data Center, go to Administration > Applications > Application links.
Click Create link.
Select External application and choose Incoming as the direction.
Fill in the details:
Redirect URL: Enter the Gearset redirect URL,
https://app.gearset.com/authorization/jira-oauth2/callbackApplication permissions: Select Write (this implicitly includes Read).
Click Save. Jira will generate a Client ID and Client secret — keep these safe, as you'll need them in the next step.
Step 2: Connect in Gearset (team owner)
Once the incoming link is set up in Jira, your Gearset team owner can complete the connection.
In Gearset, go to My connections > Source control and services (in the menu on the left).
Click Connect to Jira (OAuth 2.0). In the modal that appears, select Jira Data Center and click Connect.
Enter your Jira Data Center instance URI, the client ID, and the client secret from Step 1, then click Connect.
You'll be redirected to your Jira Data Center instance. Review the permissions Gearset is requesting (read and write access) and click Approve.
You'll be redirected back to Gearset. Your connection will appear next to the Jira OAuth 2.0 section, confirming it's set up.
Team members
Once the team owner has set up the connection, any team member can connect their own Jira account.
Go to My connections > Source control and services.
Click Connect to Jira (OAuth 2.0).
You'll be redirected to your Jira Data Center instance to approve access.
Once approved, you'll be redirected back to Gearset and your connection will be confirmed.
Each person's updates to Jira tickets will be attributed to their own account.
If the team owner hasn't set up the connection yet, you'll see a message asking you to contact your team owner to configure the Jira Data Center link first.
Removing the connection
If the team owner removes the Jira Data Center connection, all team members' connections are also removed. Individual team members can remove their own connection without affecting others.
Adding Jira tickets to deployments
When you're running a deployment, you can link Jira tickets so that Gearset automatically records what happened against them.
On the deployment summary page, click the Jira updates panel.
Search for tickets by title, description, or ticket reference (e.g.
PROJ-123).Select the tickets you want to link to the deployment.
When the deployment completes successfully, Gearset posts a comment on each linked ticket with details of what was deployed. You can configure the content of these messages in your deployment preferences.