Managing projects using Jira

You can integrate Jira with GitHub Enterprise for project management.

In this article

Connecting Jira to a GitHub Enterprise organization

  1. Sign into your GitHub Enterprise account at http[s]://[hostname]/login. If already signed in, click on the GitHub logo in the top left corner.

  2. Click on your profile icon under the GitHub logo and select the organization you would like to connect with Jira.

    Select an organization

  3. Click on the Edit organization name settings link.

    Edit organization settings

  4. In the left sidebar, under Developer settings, click OAuth Apps.

    Select OAuth Apps

  5. Click on the Register new application button.

    Register new application button

  6. Fill in the application settings:

    • In the Application name field, type "Jira" or any name you would like to use to identify the Jira instance.
    • 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 and choose Applications.

    Select Applications on Jira settings

  3. In the left sidebar, under Integrations, click DVCS accounts.

    Jira Integrations menu - DVCS accounts

  4. Click Link Bitbucket Cloud or GitHub account.

    Link GitHub account to Jira

  5. 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, deselect Auto Link New Repositories.
    • If you don't want to enable smart commits, deselect Enable Smart Commits.
    • Click Add.
  6. Review the permissions you are granting to your GitHub Enterprise account and click Authorize application.

  7. If necessary, type your password to continue.

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.