Integrate Jira Software with GitHub Enterprise Server

Use the free GitHub for Jira app to seamlessly integrate with GitHub Enterprise Server. The app allows you to easily track branches, pull requests, commits, builds, and more in Jira to stay up-to-date on your team's development work. Simply reference issue keys in GitHub to view development data in Jira and use smart commits to automate common tasks like transitioning issues or adding comments.

Before you begin

• To integrate Jira Software and GitHub Enterprise Server, you'll need admin permissions on both platforms.

• Your GitHub Enterprise Server must have a public DNS and path and allow access from GitHub for Jira’s IP range, which may require changes to your firewall settings. Reverse proxies are not supported. View GitHub IP allow list configuration and learn more about Atlassian IP addresses.

• GitHub for Jira does not support SAML SSO nor self-signed certificate. This means that if you require SSO or self-signed certificate for authorization, GitHub for Jira will not be able to connect to your GitHub Server.

API key-based pre-authorization

GitHub for Jira lets you integrate with private GitHub Enterprise servers that can't be accessed via the public internet.

To enable this feature, you’ll set up a public API gateway or a reverse proxy to forward requests to your GitHub Enterprise server. Subsequently, the server will perform pre-authorization by examining the configured custom HTTP header to detect a specific “secret” string or API key.

The API key is a secret string that is shared exclusively between the API gateway and the app within your tenancy, adding an extra layer of security to your system. You can set up the API key when configuring GitHub for Jira.

(For inspiration, see our nginx instance sample configuration: github-for-jira/sample-reverse-proxy-nginx.conf at main · atlassian/github-for-jira)

You’ll need to contact support to enable this beta feature.

Configure GitHub for Jira

1. Install the free GitHub for Jira app from the Atlassian Marketplace.

2. Select Get started. You can also come back to the GitHub for Jira page later by going to Apps > Manage apps > GitHub for Jira.

3. Select Connect GitHub organization.

4. Select GitHub Enterprise Server and click Continue.

5. Enter the URL for your GitHub Enterprise Server account in the format of http(s)://<your-github-enterprise-server-domain and click Next.

Create a GitHub app

Select Automatic app creation or Manual app creation, and click Create.

We recommend automatic app creation, as it’s faster and simpler. All you need to do is name the app, and we’ll use the GitHub API and a manifest file to pre-populate the app creation form for you. However, this does require your GitHub server to run on version 3.1 or higher. Upgrade GitHub Enterprise Server.

Automatic app creation (recommended)

If you’re creating the app automatically, you’ll be redirected to the automatic app creation page to fill in a few details.

1. Give your app a unique name and click Create GitHub App.

2. Go to http(s)://<your-github-enterprise-server-domain>/settings/apps/<your-github-app-name and update the Homepage URL to include the name of your app.

Manual app creation

If you're creating the app manually, you’ll need to create a GitHub App within your GitHub Enterprise Server account. Learn how to manually create a GitHub app.

Remove legacy DVCS connection

After you have connected all your GitHub Enterprise organizations to GitHub for Jira, you can remove them from DVCS.

1. Make sure you have added all your GitHub Enterprise organizations to GitHub for Jira.

2. Go to Jira Settings > Products > DVCS Accounts.

3. Select the icon, on the organizations you want to remove from DVCS and click Disconnect.