GitHub Enterprise integration with Jira: a step-by-step tutorial

Teamwork is an important element of the modern workplace and two of the best tools to enhance collaboration and cooperation are GitHub and Jira. While GitHub allows writing code with fellow colleagues and controlling versions, Jira is great for advanced time management due to multiple features it provides. So wouldn’t it be great if we could get the best of both tools at the same time and bring development and project management together? There are a lot of apps out there that will help you integrate Jira and GitHub, however, the fact that you can use third-party apps doesn’t mean that you should. We have prepared a step-by-step guide that will help you connect these two important tools without a single line of code or third-party apps. See all information about your branches, pull requests and commits in Jira and make working on projects more efficient.

Note: The following steps have been tested for GitHub Enterprise Cloud and Atlassian Jira Software v8.2.0, but we expect them to work with all versions of Jira Software 8.*.*.

Requirements: system admin rights for GitHub and Jira

Step 1 (GitHub)

1. In order to connect your GitHub and Jira, you need to have an OAuth access token for the account that has administrative rights for the repository. Thus you will get a “Client ID” and a “Client Secret”.

2. In order to get a “Client ID” and a “Client Secret”, go to the GitHub site and click on the avatar in the top right-hand corner → select “Settings” in the drop-down menu and click “Developer settings”.

3. Select “OAuth Apps”

and click “Register new application

You can choose any “Application name”, but the best practice is to use “Jira Server”, since we have a connection to a Jira server, or the name of the instance if it has a name.

4. Fill out the details. Homepage URL = Authorization callback URL = Base URL of the Jira instance. You can find it in your Jira system information here:

Click the Application tab and you will see the “Client ID” and “Client Secret”:

IMPORTANT:
Open Jira and GitHub as two tabs in the same browser window

Step 2 (Jira)

Requirements: admin rights

1. First, we need to link the Jira project. Click “Project Settings“→ “Development tools” (bottom left)

2. Click “Connect” and select GitHub Enterprise

3. Enter a Team or User Account = Name of the GitHub account, which is generally related to the repository (in our case, it’s “AntonActonic”)

4. Host URL = “https://github.com” in this case, as we want to connect to GitHub

5. Copy your Client ID and Client Secret from GitHub (see instructions on GitHub “OAuth” above) into the dialogue and click “Add”

VERY IMPORTANT:
You should be logged into GitHub in another tab in the same window.

6. Click “Continue” → “Grant” → “Authorize”

The account you have connected and all of its repositories will appear on the ‘DVCS Accounts‘ page and the synchronization will start automatically.

Synchronization can take up to one hour.  In the case of errors, resync individual repositories.

In the project settings, it should look like this:

And that’s it! When you have completed all the steps, you will have access to your GitHub repository directly from inside Jira.

We hope this tutorial was useful to you. If you have any questions, please contact us

Сheck out our other articles:

Let’s stay in touch!

Follow us on LinkedInFacebook and Twitter, and subscribe to our newsletter to get regular updates, tips and special offers delivered directly to your mailbox.

7 comments

Taranjeet Singh
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
May 29, 2020

@Andrei Pisklenov _Actonic_ That's great information! Thanks for sharing.

Ken Lemieux
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
June 3, 2020

 

@Andrei Pisklenov _Actonic_Thanks for the info, very helpful. 

Andrei Pisklenov _Actonic_
Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
June 3, 2020

@Ken Lemieux We don't have experience in configuration of Jira Cloud and Git hub enterprise.

Rajani Buggineni
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
October 13, 2022

@Andrei Pisklenov _Actonic_ Hi ,My Jira and Github are already connected. I can see commits for each user.How can I query PR's submitted, merged, closed against each developer. Please help me. 

Jamie Rogers April 12, 2023

@Andrei Pisklenov _Actonic_ 

Thanks for this article. We just migrated GitHub instances and had to reconfigure the integration with Jira and had been a while since we last did this. Much appreciated.

Sjaa November 16, 2023

Thanks so much for this. I have been wanting to integrate something like this for a while. 

ESTERBEN November 19, 2023

how can I see the names of the projects that are using github jira software cloud integration?

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events