Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Contact Support

Setting Project Permissions

Introduction

By default – integrations (GitLab, GitHub, etc) and individual repositories are associated with all Jira projects. Jira administrators can limit which Jira projects are associated to integrations or individual repositories.

Related Features
Associating a Jira project with an integration or repository will limit repository content displaying in:

  • Git Commits issue tab
  • Git Roll Up issue tab
  • Git integration issue side panel
  • View all repositories page
  • Repository Browser: Browse page
  • Repository Browser: Commits page
  • Repository Browser: Compare page
  • Create branch issue dialog
  • Create pull/merge request dialog

Jira users must have the View Development Tools permission in the context of a Jira project to view content from the Git Integration for Jira app.

Instructions for integrations (GitLab, GitHub, etc)

To limit which Jira projects are associated with an integration’s repositories:

  1. Navigate to Jira dashboard menu Git ➜ Manage repositories.

  2. Add a new integration or edit existing integration’s settings.

  3. Locate the Project Permissions setting.

  4. Uncheck Associate with all projects.

  5. Select one or more Jira projects (at least one must be selected).

  6. Click Update.

Video Example 1: Setting project permissions for an existing GitLab integration

Right click here to open this video in a new browser tab for more viewing options.

Video Example 2: Setting project permissions at the repository level for an existing GitLab integration

Right click here to open this video in a new browser tab for more viewing options.

 

Instructions for individual repositories

To limit which Jira projects are associated for individual repositories:

  1. Navigate to Jira dashboard menu Git ➜ Manage repositories.

  2. Add a new repository or edit existing repository’s settings.

  3. Locate the Project Permissions setting.

  4. Uncheck Associate with all projects.

  5. Select one or more Jira projects (at least one must be selected).

  6. Click Update.

Video Example: Setting project permissions for a repository

Right click here to open this video in a new browser tab for more viewing options.

 

More How-to articles

Creating Personal Access Tokens

Working with JMESPath Filters

Working with Custom API Path

Creating and configuring SSH keys (Windows/MacOS/Linux)

Require Personal Access Tokens for user actions (create branch/pull request)

Setting Project Permissions (this page)

How to get a quote?

Ways to Index Git Data to Jira Issues

Proxy settings on adding integrations (except AWS CodeCommit)

Configure Source Code Diff Viewing

Have feedback about this article? Did we miss something? Let us know!
On this page