GitKraken Desktop Documentation

GitKraken Desktop + GitLab Self-Managed Issues Integration

Last updated: March 2026

Use this page to connect GitKraken Desktop to GitLab Self-Managed Issues so you can preview, manage, filter, and branch from issues alongside your repository work. This integration shares the GitLab Self-Managed connection, requires GitLab Self-Managed 13.1 or newer, and is view-only for Community users.

The GitLab Self-Managed Issues integration is view-only for Community users. To unlock all features, consider upgrading to a paid GitKraken license.

Requirements and limits

  • Integration covered here: GitLab Self-Managed Issues
  • Server version: GitLab Self-Managed 13.1 or newer
  • Connection model: Shares the same connection as the GitLab Self-Managed integration
  • Community plan: View-only access
  • Full issue workflows: Paid GitKraken license required for editing, branching, and full issue management
Capability Community Paid plans Server/version note
Preview issues Yes Yes Requires GitLab Self-Managed 13.1 or newer
Create issues No Yes Requires GitLab Self-Managed 13.1 or newer
Edit issue details No Yes Requires GitLab Self-Managed 13.1 or newer
Create branches from issues No Yes Requires GitLab Self-Managed 13.1 or newer
Filter issues Yes Yes Uses the shared self-managed connection

Requirements

This integration requires GitLab Self-Managed version 13.1 or newer.


Quick Start

  1. Connect your GitLab Self-Managed instance from Preferences > Integrations by following the GitLab Self-Managed authentication flow.
  2. Open the ISSUES section in the Left Panel to load issues from the connected instance.
  3. Preview, filter, and open issue details directly in GitKraken Desktop.

To edit issues, create issue-based branches, or open issues in GitLab Self-Managed, use the same workflows documented for GitLab Issues.


How to connect the GitLab Self-Managed Issues integration

The GitLab Self-Managed and GitLab Self-Managed Issues integrations share the same connection.

Use GitLab Self-Managed Issues in GitKraken Desktop when: you already have the self-managed GitLab integration connected and want issue workflows next to your repository work. Don’t use this page when: you still need to configure the underlying self-managed GitLab connection first.

Set up the integration from the ISSUES section in the Left Panel or from Preferences > Integrations.

Follow these GitLab Self-Managed authentication steps to connect your instance.


What the GitLab Self-Managed Issues integration supports

Once connected, the GitLab Self-Managed Issues integration provides the same functionality as the GitLab Issues integration:

Use the in-app issue workflow when: you want issue context, filtering, and branching without leaving GitKraken Desktop. Don’t rely on it alone when: you need broader project-management features outside the issue workflows documented here.

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