Getting Started

Installation & Setup

Prerequisites

Before installing, confirm:

  1. Your instance is Jira Cloud. On Atlassian Government Cloud, see the Atlassian Government Cloud tab instead - installation works differently there.
  2. You have access to the Atlassian Marketplace from within Jira

For Site Admins - Installing the App

Step 1 - Find the App on the Marketplace

StepAction
1Go to marketplace.atlassian.com and search for "GitConnect for Jira with GitHub and GitLab"
2Click Try it free or Buy now

Step 2 - Connect to Your Site

  • Select your Atlassian Cloud site when prompted
  • Sign in if needed
  • Choose Jira

Step 3 - Review & Confirm Permissions

  • Review the permissions the app requires and click Accept
  • Start the free trial or purchase - the app installs automatically, no restart required

Step 4 - Manage the Installed App

  • Go to admin.atlassian.com → Apps → Manage Apps to configure, manage the license, or uninstall

For End Users - Requesting the App

If you don't have site admin access, you can still request the app:

  1. Find GitConnect for Jira with GitHub and GitLab on marketplace.atlassian.com
  2. Click Try it free to send a request to your site admin, with justification if prompted
  3. Your admin approves or denies the request - you're notified once it's approved

Verify Installation

After installation:

  1. Click Apps in the Jira top navigation bar
  2. Look for GitConnect for Jira in the dropdown menu
  3. Click it to open the app's admin console - Manage Integrations should load

Note: If the app does not appear within a few minutes, refresh the page or clear your browser cache.

Permissions Requested During Install

PermissionWhy It's Needed
Read Jira issues and projectsMatch commits, branches, and merge/pull requests to the correct issue key
Administer Jira (admin only)Required to install the app from the Marketplace

Pricing

GitConnect for Jira with GitHub and GitLab is a paid app (commercial license) billed through your Atlassian account. A free trial may be available before purchase - see the Marketplace listing for current pricing and trial terms.

First Steps After Install

Once installed, complete these setup tasks before rolling out to your team:

  1. Grant the Manage Integrations permission (Jira Settings → System → Global permissions) to whoever will connect repositories - see Permissions
  2. Connect your first repository - see Connecting Your First Repository
  3. Grant the View Development Tools Jira permission to the users, groups, or project roles who should see development activity on issues

Uninstalling

To uninstall: go to admin.atlassian.com → Apps → Manage Apps → click GitConnect for Jira → Uninstall.