Managing projects using JIRA

In this article

• Connecting JIRA to a GitHub Enterprise organization
• Connecting JIRA to a GitHub Enterprise personal account
• JIRA instance configuration

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.

Connecting JIRA to a GitHub Enterprise personal account

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 Applications.
4. In the upper right corner of the Developer applications box, click Register new application.

5. 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.
6. Click Register application.
7. 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.