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
- Connect to Git repository
- Enable all or Disable all
- Bulk change
- Indexing options
- Webhooks
- Related helpful tips
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.
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.
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.
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
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.
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.
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.
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.
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.
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.
