GitLab for Jira Cloud app administration

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab Self-Managed

For user documentation, see GitLab for Jira Cloud app.

With the GitLab for Jira Cloud app, you can connect GitLab and Jira Cloud to sync development information in real time. You can view this information in the Jira development panel.

To set up the GitLab for Jira Cloud app on your GitLab Self-Managed instance, do one of the following:

For an overview, see:

The videos above show the older Universal Plugin Manager interface which might be unavailable on newer Jira Cloud instances. The following instructions cover both old and new app management interfaces.

If you install the GitLab for Jira Cloud app from the Atlassian Marketplace, you can use the project toolchain developed and maintained by Atlassian to link GitLab repositories to Jira projects. The project toolchain does not affect how development information is synced between GitLab and Jira Cloud.

For Jira Data Center or Jira Server, use the Jira DVCS connector developed and maintained by Atlassian.

Set up OAuth authentication

Whether you want to install the GitLab for Jira Cloud app from the Atlassian Marketplace or manually, you must create an OAuth application.

Prerequisites:

  • Administrator access.

To create an OAuth application on your GitLab Self-Managed instance:

  1. In the upper-right corner, select Admin.

  2. In the left sidebar, select Applications.

  3. Select New application.

  4. In Redirect URI:

    • If you’re installing the app from the Atlassian Marketplace listing, enter https://gitlab.com/-/jira_connect/oauth_callbacks.
    • If you’re installing the app manually, enter <instance_url>/-/jira_connect/oauth_callbacks and replace <instance_url> with the URL of your instance.

  5. Clear the Trusted and Confidential checkboxes.

    You must clear these checkboxes to avoid sign in errors.