March 28th 1 PM ET
Free Workshop: Escape the chaos of context-switching

GitKraken Client Documentation

GitKraken Client FAQ

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 Client support TFS, Visual Studio Team Service or Azure DevOps?

Yes, for Azure DevOps (previously VSTS), you can use our integration with Azure DevOps!

For TFS instances 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 will need to enable Basic Authentication in IIS for TFS.

If authenticating to TFS via username and password is not working, try creating a Personal Access Token (PAT) to use in place of a password.

For more information authenticating with repos, check out our SSH and HTTPS page.


What Linux distributions are supported by GitKraken Client?

GitKraken Client currently supports Ubuntu 16.04 LTS+, RHEL 7+, CentOS 7+, and Fedora 30+. While GitKraken Client might be able to be installed on other distros, we cannot guarantee that it will behave properly.


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

By default, GitKraken Client connects to one integration at a time. However, a paid GitKraken license provides multiple profile support, allowing you to easily switch between profiles that each have their own associated integrations.

If you have a GitKraken Pro, Teams, or Enterprise license, set up profiles to configure a GitHub, GitLab, Bitbucket, or Azure DevOps account for each profile.


How do I change the avatar associated with my commits?

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


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

Yes, your GitKraken paid subscription is associated with your email address, not a specific computer. So you can use GitKraken Client on as many computers as you’d like. 🖥️


Why can’t I see remotes under my integration drop-down menu?

The remote drop-down menu is for adding remotes from an integration (such as GitHub, GitLab, Bitbucket, etc.) and will only display forks of the repository. To add a remote that is not a fork, use the URL option instead.


How do I push a local project from my GitKraken Client to GitHub, Bitbucket, GitLab, or Azure DevOps?

You need to change your branch’s upstream and force push.

  • Initialize a blank project on GitHub, GitLab, Bitbucket, or Azure DevOps.
  • Open your local project in GitKraken.
  • Add your newly initialized project as a remote using the URL option.
  • Update your branch’s upstream so it points to your new remote.
  • Push the branch. You will be prompted to , which is the correct action to take for this use case.

You are done! Your local project is now on your hosting service.


How do I sign out of GitKraken?

You may sign into a different account by selecting your profile icon in the top right corner and selecting Sign into a different account.

While there is no way to sign out of GitKraken, you may delete all of your GitKraken data by deleting the ~/.gitkraken folder. You can find the Data Location for your operating system here.

Technical issues


I receive a “Could not find a compatible repository” for one of my repos. How can I fix that?

That error usually indicates something is stopping GitKraken from opening the repo. If you have this project open in another tool, such as an IDE, try closing that application and then relaunching GitKraken Client.

If you have git installed, try running git status from the terminal. If you have pending changes, try stashing or committing those changes or switching branches, and see if that allows you to load the repo in GitKraken Client.

There could also be an issue with the directory path itself. Try cloning this repository to a different local directory.


I just downloaded GitKraken Client and it is not working.

If you are on Linux and are unable to launch GitKraken Client 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 Client.


I just subscribed but FREE is still shown in the lower right corner.

Be sure you are logged in with the same email address registered with your GitKraken subscription. Click your profile icon in the upper right corner to check which email you’re using or to sign into your account.


I’m having an SSH issue.

The most common issues are:

  • 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.

  • Use of SSH config — GitKraken Client 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 Client or use your system’s SSH agent to authenticate with your remote.

  • SSH-agent on Windows — GitKraken Client 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 Client.

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.

If you are attempting to use GitKraken Client with a repository owned by a different individual, consider forking their repository to use GitKraken Client for your changes. Otherwise this other individual will need to first install GitKraken Client and connect it to GitHub to authorize GitKraken.


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

GitKraken should activate and run automatically 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 be compatible 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):

  • If you’re having issues using GitKraken through a proxy, 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.

Learn more on our SSH, HTTPS, & Proxies page.


My commit graph is not showing up correctly.

Sometimes a repository can get in an unexpected state that causes it to not work correctly in GitKraken Client. This may be your commit graph not showing up at all or seeing the message “Displaying 2000 commits”.

Try running git gc from the terminal on this repository and then relaunching your GitKraken Client. You can also try taking a fresh clone of the repository in a new location.


I’m having display or graphical issues

Hardware acceleration may cause graphical instability or other issues on some systems, such as GitKraken Client displaying in a blank window.

You can disable GPU hardware acceleration by running GitKraken Client from a command line with the the following command:

gitkraken --disable-gpu

My files are not showing up as expected or have strange characters.

GitKraken Client expects most files to use UTF-8 file encoding. If you are using another encoding type, you can set your type at the top when editing your file, or per-repository from the preferences menu.

You can also set your file encoding to GUESS ENCODING and GitKraken Client will try to match the file encoding so that it is displayed correctly. Take care to select the correct file encoding when editing the file, as selecting the incorrect encoding could lead to unexpected errors.


How to get SILLY (extended) logs

To obtain extended SILLY (extended) logs:

  • Close GitKraken
  • (optional) Rename or move the logs folder under ~.gitkrakenlogs. The data location for this folder on your OS can be found here
  • Start GitKraken from the CLI using the command gitkraken -d SILLY
  • Reproduce the issue or error
  • All logs will be under the logs folder

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

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