GitKraken Desktop FAQ

Last updated: May 2025

The answers to your most frequently asked questions.

Features and Interface

Does GitKraken support TFS, Visual Studio Team Services, or Azure DevOps?

Yes. GitKraken integrates with Azure DevOps. For TFS, clone the repository manually using File > Clone Repo and provide the HTTPS URL. On Mac or Linux, enable Basic Authentication in IIS for TFS. Consider using a Personal Access Token (PAT) if password authentication fails.

More info: SSH and HTTPS authentication

What Linux distributions are supported?

GitKraken supports:

• Ubuntu 18.04 LTS+
• RHEL 8+
• Fedora 39+

Other distributions may work but are not officially supported.

Can I use multiple GitHub/GitLab/Bitbucket/Azure DevOps accounts?

Yes—with a paid license. Use Profiles to configure separate integrations for each account.

How do I change my commit avatar?

Your avatar is linked to your .gitconfig email address via Gravatar. Update your Gravatar to change your displayed avatar.

Can I use GitKraken on multiple computers?

Yes. Subscriptions are linked to your email address, not a specific machine.

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

The drop-down only shows forks. Use the URL option to add other remotes.

How do I push a local project to GitHub or other remotes?

1. Initialize a new project remotely.
2. Open your local project.
3. Add the new project as a remote.
4. Set your branch’s upstream.
5. Push and confirm the Force Push prompt.

How do I sign out of GitKraken?

While there’s no sign-out button, you can:

• Click your profile icon → Sign into a different account
• Or delete the ~/.gitkraken folder to reset data

Technical Issues

Why am I getting a repo compatibility error?

Try closing other tools like IDEs, then relaunch GitKraken. Use git status to check for uncommitted changes. Try switching branches or cloning to a new directory.

Why won’t GitKraken launch on Linux?

Launch from terminal to check for missing dependencies. Refer to the installation guide.

Why does my subscription show COMMUNITY?

Verify that you’re logged into the email associated with your subscription. Check this via your profile icon.

Why isn’t GitKraken authenticating my SSH key?

• Confirm remote URLs start with ssh:// or {user}@{host}:{repo}.
• GitKraken does not use ~/.ssh/config. Load the key manually or use your OS agent.
• On Windows, only Pageant is supported. Download here.

Why can’t GitKraken access my GitHub remote?

• Confirm GitKraken is authorized.
• Org access may require approval from the owner. Request access.

Why can’t GitKraken connect to the internet (firewall or proxy)?

• GitKraken works with most firewalls but some PACs or proxy settings may need manual config.
• Use http.proxy or remote.<name>.proxy in Git config. See Authentication.

Why is the graph missing commits or showing errors?

Run git gc in terminal or clone into a fresh directory.

Why is the window blank or UI not displaying properly?

Launch GitKraken with:

gitkraken --disable-gpu

Why is my file encoding incorrect or unreadable?

Set encoding to UTF-8 or use GUESS ENCODING under repository preferences.

How can I enable extended logging for troubleshooting?

1. Close GitKraken
2. Rename or delete ~/.gitkraken/logs
3. Start GitKraken using: gitkraken -d SILLY
4. Reproduce the issue
5. Logs will be saved in the new logs folder