Frequently Asked Questions

The answers to your important Frequently Asked Questions.


Just a sec! Before you dive in, perhaps one of these resources might help?

Features & interface

Does GitKraken support GitLab?

Yes, GitKraken integrates perfectly with GitLab. To connect to your GitLab instance, follow Preferences Authentication.

You can also use GitLab Community Edition with GitKraken! You will need to clone your repo File Clone Repo and then enter the repository URL.

Does GitKraken support GitHub Enterprise?

Yes, GitKraken integrates perfectly with GitHub Enterprise. To connect to your GitHub Enterprise instance, follow Preferences Authentication.

Does GitKraken support Bitbucket Server?

Yes, you can use Bitbucket Server with GitKraken! You will need to clone your repo File Clone Repo and then enter the repository URL (which can be found at the top-right of your Bitbucket Server Project page).

Does GitKraken support Visual Studio Team Service or TFS?

Yes, you can use VSTS or TFS with GitKraken!

You will need to clone your repo File Clone Repo and then enter the HTTPS repository URL (which can be found at the top-right of your Code page).

If you're connecting to a remote TFS Git server from a Mac or Linux, you would need to enable Basic Authentication in IIS for TFS.

How can I open the command line from GitKraken?
How can I see what commands GitKraken makes to the CLI?

Unlike other Git GUI clients, GitKraken is not a front-end GUI for your command line; no Git tools are required. It works directly with your repositories with no dependencies, which means a separate Git installation isn’t even required.

There is an option to open the current repo folder in terminal. Just go to File Open Terminal or use the keyboard shortcuts opt + T (Mac) / alt + T (Windows + Linux). You can set your default terminal from Preferences General.

How can I use multiple GitHub / Bitbucket accounts with GitKraken?

By default, GitKraken connects to one GitHub account (or one Bitbucket account) at a time. However, with GitKraken Pro‘s multiple profile support, you can easily switch between profiles that each have their own associated GitHub and BitBucket accounts.

Does GitKraken support Git LFS?

GitKraken does not currently support Git Large File Storage (LFS).

Does GitKraken have keyboard shortcuts?

Yes! You can type ⌘ | Ctrl + / while in the app to open a list of all available shortcuts.

You can also take a look at our keyboard shortcuts reference here on the support site.

How do I change the avatar associated with my commits?

Your commit avatar in GitKraken is linked to the Gravatar, which is linked to your .gitconfig email address. If you change your Gravatar, your avatar in GitKraken will update itself.

Can I use my GitKraken Pro license on more than one computer?

Yes, your GitKraken Pro paid subscription is associated with your email address, not a specific computer. So you can use GitKraken Pro on as many computers as you'd like!

Technical issues

I just downloaded GitKraken and it is not working.

If you are on Linux and are unable to launch GitKraken after installation, try to launch the application from the terminal to verify that there are no missing dependencies. Also, be sure to check out our page on How to Install GitKraken.

I just subscribed but I do not see PRO in the lower right corner.

Be sure you are logged in with the same email address registered with your GitKraken Pro subscription. You can check by navigating to Sign into a different account, and then verify that your email is correct.

I'm having an SSH issue.

Unlike other Git GUI clients, GitKraken is not a front-end GUI for your command line. It tries to imitate CLI interactions as best it can, but some things are still missing. The most common issues are:

  1. Misconfigured SSH settings — If you are using SSH (your remote url takes the form of ssh://{host}/{repo} or {user}@{host}:{repo}), go to Preferences Authentication to confirm that your SSH settings are correct.
  2. Use of SSH config — GitKraken does not currently respect your SSH config and cannot make use of any remote server nicknames or identities. You can either load your SSH key directly into GitKraken or use your system’s SSH agent to authenticate with your remote.
  3. SSH-agent on Windows — GitKraken currently only supports Pagent for the SSH agent. You can download PuTTY and Pagent from their page here.

I can't view any of my GitHub remotes from GitKraken.

GitKraken needs to be authorized in your GitHub account in order to browse remote repositories, view and create pull requests, and perform other actions. You can double-check that GitKraken is authorized from your GitHub authorized applications page.

If GitKraken is authorized on your GitHub account, you should be able to browse and connect to any of your personal repositories. However to connect to any repositories owned by an organization, GitKraken usually also needs to be authorized by the organization. After authorizing GitKraken on your own account, you can make access requests to your organizations from here. Requests must be approved by organization owners, as explained in GitHub's documentation.

I'm having an issue using GitKraken behind a firewall.

GitKraken should activate and run just fine behind standard firewall setups. Due to the highly variable nature of firewall configurations, we cannot troubleshoot individually, nor can we guarantee that your setup will play nicely with GitKraken.

I can't get GitKraken to run behind a proxy. Is there anything I can do to make it work?

GitKraken supports both authenticated and non-authenticated proxies, but some PACs and URL-based settings still may not work. If this applies to you, there are some workarounds (please note that there is no guarantee that these fixes will work for all users):

  • We recommend that any users having issues using GitKraken through a proxy should use the http.proxy Git config setting. Add your proxy to this file and give it a whirl.
  • If that doesn't work, configuring remote.<name>.proxy might help. Bear in mind that local (repo-specific) settings override the settings your global Git config.

Can't find your question here? Contact us and ask away.