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

Contact Support
GitKraken Status  

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, see GIJ Webhooks documentation.

 

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

 

More related topics on setting up repositories

Git integration configuration page (this page)

Using the Add new integration wizard

Using the Connect Repository wizard

Connecting a repository via Advanced setup

Adding a repository hosted on Windows Server or Windows Network Share

Setup repository root not located in Jira HOME directory

Tracked folders overview

Self-signed HTTPS integration

Managing repository or integration configuration

Associating project permissions

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