Discover Jira Cloud products
Learn more about Jira Cloud products, features, plans, and migration.
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
From the top navigation, go to Apps > Explore more apps.
Search for GitHub for Jira, then select it from the list.
Select Get app, then Get it now.
Set up GitHub for Jira
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.
Select Continue.
Select GitHub Cloud, then Next.
Enter your GitHub username and password, then select Sign in.
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:
Sign in to your Jira Cloud account
From the top navigation bar in Jira, select Apps > Manage your apps > GitHub for Jira > Get started.
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:
Was this helpful?