Integration Guide

github logo GitHub Integration Jira Cloud

Connecting to a GitHub Git Repository

This process requires an existing GitHub git repository.

Github repository home

On your Jira Cloud dashboard menu, go to Git > Manage Git Repositories.

The git configuration page for connecting repositories is displayed.

On the Auto-connect integration panel, click GitHub.

git for jira cloud auto-connect panel - select github

Complete the requirements for each step of the Connect to Git Repository wizard.

If your git url contains multiple repositories, it will be added as tracked repositories in the git configuration list.  Otherwise, a git repository is added instead.

Repositories added or removed from GitHub will be likewise added or removed from Jira Cloud.

Setting Up GitHub Permissions

We recommend using a "service user" in GitHub (example: "GitIntegrationforJira") to be used to integrate GitHub with the Git Integration for Jira add-on.  This dedicated "service user" will allow the GitHub administrator to set permissions so the add-on clones only the desired repositories.

Assign GitHub permissions for team members or collaborators to allow which resources are accessible for service users. This feature is only available in a GitHub Organization.

Default Repository Permission

  1. Login to your account.
  2. Go to Settings.
  3. Under Organization settings, click Member Privileges.
  4. Github default repository permission Choose the default permission level for organization members.  The default repository permission only applies to organization members and not to outside collaborators.  If the default permission is set to None, organization members will need to be given access to repositories using the Teams or Collaborators methods (see below).
  5. Save the changes.

For more information, see Access Permissions on GitHub.

Teams and Collaborators

To give a member additional access, they must be added to a team or make them collaborators on individual repos.

Set default repository permission for the current team:

  1. Open an organization team. (Your org > Team > scroll down to the bottom then click the desired team.)
  2. Click the Repositories tab.
  3. GitHub Manage Repository permissions tab
  4. Set Read, Write or Admin repository access as desired.

Assign members to a team on your GitHub repository:

  1. Create a team in your GitHub Organization.
  2. Invite a member to add it into the team.  An email invitation is sent to that GitHub service user.
  3. Add members to team dialog The service user is then added to the team if the invitation has been accepted.
  4. Click the service user to manage permissions for this member to:
    • Set desired Role for this member.
    • Convert this member to outside collaborator.
    • Give this member access to organization repositories.
    • Remove this member from the team.
  5. Click Manage access to manage repository access for this member.
  6. Manage team repository permission

For more information on organization teams, see GitHub: Organizing Members into Teams.

For more information on inviting collaborators, see Inviting Collaborators to a Personal/Organization Repository.