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

Contact Support

Git integration configuration page

On this page, you will be able to setup your git repositories and connect them to Jira via Manage git repositories page. Utilize the following features for git integration and configuration:


Add new integration panel

Formerly known as Auto-Connect integration panel.

In here, you will find special integration options for specific git hosts. This feature supports multiple connected repositories and automates git integration.

We highly recommend this feature for multiple repository configuration.

For more details on supported git hosts, see the Auto-connect section in our Integration guides.

The Add tracked folder connection feature is added to the Add new integration panel for easy access.

GitLab
We are dropping support for Gitlab API v3. Please use GitLab API v4 when adding new integrations for increased security.

Connect to Git repository

This feature opens the Connect wizard.

You can connect single git repositories using this setup such as git protocol, SSH, HTTP/HTTPS, etc. Clicking the adjacent  will open the dropdown list of integration options such as Add tracked folder and equivalent integration connection options. |

Enable all or Disable all

The Enable all function will enable each integration in the repository list and mark all checkboxes in the Enabled column.

The Disable all function will disable each integration in the repository list and unmark all the checkboxes in the Enabled column.

Bulk change

Bulk change provides an easier way to import or export repository configuration. This feature is useful when you are migrating from an old server to a new server and is also recommended when upgrading to a new version of Git Integration for Jira app.

Export Configuration  –  this function will export your repository integration configuration to a tab-delimited file (.TSV).

Import Configuration  –  this function will import your repository integration configuration from a tab-delimited file (.TSV).

For more information, see Bulk change.

Indexing options

Reindex all integrations  –  this function will perform a reindex queue of all integrations in the repository list. Disabled integrations are ignored.

NEW FEATURE — VERSION 4.7+
Reset all indexes  –  Jira administrator can start the reset index process for all repositories using "Reset all" in the "Indexing" dropdown menu on the "Manage Git Integrations for Jira" page.

Indexing operations may require several hours for large and/or numerous repositories.

For more information on this topic, see Reindexing.

Webhooks

Opens the Webhooks configuration page. Enable/disable webhooks to trigger immediate reindex of the connected git repositories and integration.

For more information about this topic, click here to go to the Webhooks documentation page.

Related helpful tips

SSH
When setting up repositories with the Git Integration app, you need to have the necessary access permissions on the private key on the Git server to proceed.

Windows Server
For cases when git repositories are hosted at Windows servers (Windows Server network drive) — while it is using the Windows server networking, the network credentials accessing the git repository must be the same as the user running Jira.

Windows Network Share
When using Windows network sharing for the repository origin, it is recommended to allocate repositories’ paths shorter than 256 characters.

Example: \WS129custom-repoproject-z

Otherwise, the provided URL will not be recognized as valid.

For Jira hosted on Windows
When using Active Directory accounts for repository access, changing the password of the AD account running Jira can cause repository authentication issues.

The solution for this is to restart Jira to regain access to repositories.

Repository REST API
As of v2.8.3+ of the Git Integration for Jira app, the REST API for managing repositories are implemented. The documentation for this feature is available at Repository REST API.

Integration REST API
As of v3.5.0.2+ of the Git Integration for Jira app, the REST API for managing integrations are implemented. The documentation for this feature is available at Integration REST API.

Prev: Setting up repositories

Next: Using the Add new integration wizard

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