Getting Started

Getting started is easy. Install our app, set up your repository and have your team start making commits referencing the Jira issues they are working from.

App Install via Atlassian Marketplace

Visit the Jira Git Integration Atlassian Marketplace page. Select the “Try it free” button to begin the installation. Follow the prompts to complete the installation. This application supports installing repos from multiple different git service providers and your own self-hosted servers.
We also have a specific Git Jira Integration for each of the following Git services:

Setting Up Permissions

Firstly to be able to access the configuration page of the app, please make sure that you are an admin user on the Jira instance. For this, you need to be added either to the administrators or site-admins group.

Setup Your Repository

Connecting to your Git repository in Jira is simple. After you have installed the Git Integration for Jira Software you can navigate to our repository configuration page by selecting Apps -> Git Integration for Jira Software from the top navigation in Jira.
The configure page allows you to connect to your AWS CodeCommit, Azure DevOps, Azure DevOps Server, Beanstalk, Bitbucket, Gitea, GitHub, GitHub Self-Hosted, GitLab, GitLab Enterprise Edition, GitLab Community Edition and other git repositories. Select the repository and authenticate your account. Connection with the Gitea, AWS CodeCommit, GitHub Organizations, Beanstalk, GitHub Enterprise, GitLab Enterprise, Self-Hosted Git is more difficult so see additional instructions.
Once a connection has been made you can view the connection details, refresh, or disconnect at any time. All repositories belonging to your account will appear as shown below. By default, they are turned off.
The connection can be turned on or off by the toggle button as shown turned on below.
The Action menu allows you to view logs, clear logs, and set project permissions for a repository.
For your convenience, you can view logs to see the indexing history of your git commits.

Checking and clearing Logs

Click the “Action” icon nearby the enabled repository. If you select “Logs” the information list about logs will be opened.
But if you select “Clear logs” nothing will be shown but logs will be cleared. It could be checked by viewing the “Logs”.

Using Repo Explorer

Click the “Repo Explorer” icon nearby an enabled repository.
You should be able to see the information about all commits and branches of the selected repository.

Select project permissions

In the configuration settings for each connected repository is the ability to define which Jira projects the repository is connected with. By default, it's available in all projects. You may want to restrict the repo to be visible only in certain projects to limit user access to git and code information.

Linking Git commits to your Jira Issue

Linking your Git commits to a Jira issue is super easy. When a developers commits their code all they need to do is reference the issue they are working on.
In the example below I map a specific commit to the Jira issue BW-32 $ git add docs/* $ git commit -m “BW-32 This is my commit message”

Congratulations you are all set

At this point you've conneted your git service, enabled your repos, and linked your first git commit to Jira. To dive into more capabilities of this app continue to read the Features section.