• Products
  • Documentation
  • Resources

Integrate Jira Software with GitHub Cloud

Use the free GitHub for Jira app to seamlessly integrate with GitHub Cloud. With the app, you can easily track branches, pull requests, commits, builds, and more in Jira to stay up-to-date on your team's development work.

Then, add issue keys in GitHub to view development data in Jira. And use smart commits to automate common tasks like transitioning issues or adding comments.

These instructions are for GitHub Cloud and GitHub Enterprise Cloud. Read instructions for GitHub Enterprise Server

To install and set up the GitHub for Jira app, you need:

  • Jira site administrator permissions.

  • GitHub organization owner permissions.

Install the GitHub for Jira app

  1. From the top navigation, go to Apps > Explore more apps.

  2. Search for GitHub for Jira, then select it from the list.

  3. Select Get app, then Get it now.

Set up GitHub for Jira

  1. If you have just installed the app, select Get started. Otherwise, from the top navigation, go to Apps > Manage your apps > GitHub for Jira > Get started.

  2. Select Continue.

  3. Select GitHub Cloud, then Next.

  4. Enter your GitHub username and password, then select Sign in.

  5. Select the organization you want to connect to Jira, then select Install or Connect.

If you're using IP allowlists in your GitHub org, you may experience issues using GitHub for Jira. GitHub blocks some requests to the API even if the correct IP addresses are listed in the IP allowlist. To work around this problem, you must add the IP addresses 13.52.5.96 through 13.52.5.111 to your IP allowlist (you must add each IP address individually, not as a CIDR range). If our servers' IP address range changes, you must add the new IP addresses to continue using GitHub for Jira. Learn more about GitHub IP allowlist configuration.

If you experience any problems with IP allowlists, please raise an issue so we can help you.

Connect new GitHub repositories

If you originally gave the GitHub for Jira app access to "All repositories", and you've created a new repository on GitHub after configuration, your new repository will automatically work with the integration. However, if you installed the app on a subset of repositories, you will need to manually edit your repository selection by:

  1. Sign in to your Jira Cloud account

  2. From the top navigation bar in Jira, select Apps > Manage your apps > GitHub for Jira > Get started.

  3. Select Configure next to the relevant GitHub organization and add the new repository you want the app to integrate with.

After connection and configuration

Learn more about how to:

  • Link development information in a Jira project here.

  • Automate your company-managed projects with GitHub development and deployment information here.

 

Additional resources

To learn more or get help setting up and using GitHub for Jira for GitHub Cloud:

 

Additional Help