This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2020-11-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Managing projects using JIRA

You can integrate JIRA with GitHub Enterprise for project management.

In this article

Did this doc help you?

Connecting JIRA to a GitHub Enterprise organization

  1. Sign into your GitHub Enterprise account at http[s]://[hostname]/login.
  2. In the upper right corner of any page, click the account settings (gear) icon.
  3. In the left sidebar, click the name of your organization.
  4. In the left sidebar, click Applications.
  5. In the upper right corner of the Organization applications box, click Register new application.
  6. Fill in the application settings:
    • In the Application name field, type "JIRA".
    • In the Homepage URL field, type the full URL of your JIRA instance.
    • In the Authorization callback URL field, type the full URL of your JIRA instance.
  7. Click Register application.
  8. At the top of the page, note the Client ID and Client Secret. You will need these for configuring your JIRA instance.

JIRA instance configuration

  1. On your JIRA instance, log into an account with administrative access.
  2. At the top of the page, click the settings (gear) icon.
  3. In the settings dropdown, choose Add-ons.
  4. In the left sidebar, under Source control, click DVCS accounts.
  5. Click Link Bitbucket or GitHub account.
  6. In the Add New Account modal, fill in your GitHub Enterprise settings:
    • From the Host dropdown menu, choose GitHub Enterprise.
    • In the Team or User Account field, type the name of your GitHub Enterprise organization or personal account.
    • In the OAuth Key field, type the Client ID of your GitHub Enterprise developer application.
    • In the OAuth Secret field, type the Client Secret for your GitHub Enterprise developer application.
    • If you don't want to link new repositories owned by your GitHub Enterprise organization or personal account, unselect Auto Link New Repositories.
    • If you don't want to enable smart commits, unselect Enable Smart Commits.
    • Click Add.
  7. Review the permissions you are granting to your GitHub Enterprise account and click Authorize application.
  8. If necessary, type your password to continue.

Did this doc help you?