Gitkraken Linux

Posted on by



The answers to your important Frequently Asked Questions.

  1. Gitkraken Linux Install
  2. Gitkraken Linux Free
  3. Gitkraken Raspberry Pi

In Linux: set theDISPLAY environment variable, download and install the Linux version of GitKraken, and run it. Before we begin Make sure you have WSL 2 installed and configured. GitKraken Self-Hosted runs on a Linux virtual machine (CentOS, Ubuntu, or RHEL7) inside Docker containers, so before we can boldy go where no Kraken has gone before, we'll have to install Docker. Jump to RedHat Enterprise Linux 7.

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

  • GitKraken Cheat Sheet
  • GitKraken for GitHub Users Cheat Sheet

Features & interface

Does GitKraken 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?

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

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. It works directly with your repositories with no dependencies, which means a separate Git installation isn’t required.

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

By default, GitKraken connects to one integration 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.
If you have PRO, 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 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 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 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 GitKraken 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.

Can I access repos for GitHub Enterprise, GitLab Self-Managed, Bitbucket Server or Azure DevOps with my Individual subscription?

Yes you can! From a new tab navigate toClone a repo Clone Clone with URL. From here enter the remote SSH or HTTPS URL and click .

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.

If you have CLI installed, try running git status. 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.

On Windows machines, it is possible that a file path became too long.

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

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

  • 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.
If you are attempting to use GitKraken with a repository owned by a different individual, consider forking their repository to use GitKraken for your changes. Otherwise this other individual will need to first install GitKraken 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.

Install

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

GitKraken keeps spinning when opening a repo. Can I use it with repos on DropBox or OneDrive?

GitKraken does not support opening repos hosted on DropBox or OneDrive. We recommend moving your repo to a location on your machine, and then opening the repo from there.

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. 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 GitKraken. You can also try taking a fresh clone of the repository in a new location.

My files are not showing up as expected or are marked as binary.

GitKraken Git GUI only supports UTF-8 file encoding. Files may display in an unexpected way or be marked a binary if files are not encoded in UTF-8.

You can use and external diff and merge tools to work on files using other encoding types.


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

GitKraken Self-Hosted runs on a Linux virtual machine (CentOS, Ubuntu, or RHEL7) inside Docker containers, so before we can boldy go where no Kraken has gone before, we'll have to install Docker.

Jump to CentOS
Jump to Ubuntu
Jump to RedHat Enterprise Linux 7

Install Docker CE on CentOS

These instructions can also be found on Docker's documentation site.

With internet access

  1. Install required packages:
  1. Use the following command to set up the stable repository:
  1. Update the yum package index:

Gitkraken Linux Install

  1. Install the latest version of Docker:
  1. Edit /etc/docker/daemon.json. If it does not yet exist, create it:
  1. Start Docker:
  1. Switch to root user:
  1. Download Docker Compose:
  1. Apply executable permissions:
  1. Install GitKraken Self-Hosted - jump to Installation section.

Without internet access

  1. Download Docker CE and Docker Compose packages from a machine with internet access.
  2. Docker CE for CentOS (both the docker-ceselinux and the docker-ce of the same version (e.g. 17.03.1))

  3. Get the 3 files over to the host server where Docker will be installed.

  4. Install Docker (change the path to where you copied the files, and the package names appropriately):

  1. Copy and rename the Docker Compose file to /usr/local/bin/docker-compose:
  1. Change access permission for docker-compose:
  1. Edit /etc/docker/daemon.json. If it does not yet exist, create it:
  1. Start Docker:
  1. Install GitKraken Self-Hosted - jump to Installation section.

Install Docker CE on Ubuntu

These instructions can also be found on Docker's documentation site.

With internet access

  1. Install packages to allow apt over HTTPS:
  1. Add Docker's GPG key:

You can verify the key with: sudo apt-key fingerprint 0EBFCD88

  1. Set up the stable repository:
  1. Update apt package index:
  1. Install Docker:

Gitkraken Linux Free

  1. Switch to root user:
  1. Download Docker Compose:
  1. Apply executable permissions:
  1. Install GitKraken Self-Hosted - jump to Installation section.

Without internet access

  1. Download Docker CE package from a machine with internet access.
  2. Docker CE for Ubuntu choose your Ubuntu version, browse to pool/stable, and choose your architecture.

You can check your version using: lsb_release -a

  1. Download Docker Compose package from a machine with internet access.

  2. Get the 2 files over to the host server where Docker will be installed.

  3. Install Docker (change the path to where you copied the files, and change the package names appropriately):

  1. Move Docker Compose file and rename it:
  1. Apply executable permissions:

Install Docker CE on RHEL7

With internet access

  1. Install required packages:
  1. Use the following command to set up the stable repository:
  1. Update the yum package index:
  1. Install the latest version of Docker:
Gitkraken
  • Note: If you would like to install the latest version of Docker CE, you can run the following command to get the latest version:

Insert the desired Docker CE version into the install command by replacing that portion of the string for the Docker CE version and the selinux version.

  1. Edit /etc/docker/daemon.json. If it does not yet exist, create it:
Gitkraken
  1. Start Docker:
  1. Switch to root user:

Gitkraken Raspberry Pi

  1. Download Docker Compose:
  1. Apply executable permissions:
  1. Install GitKraken Self-Hosted - jump to Installation section.

Install GitKraken Self-Hosted

  1. Extract GitKrakenEnterpriseServer.zip in a folder of your choosing(all commands in the following instructions will be performed in that folder).

  2. Load the images into Docker:

  1. Configure what port GitKraken Self-Hosted should run on the host server.By default GitKraken Self-Hosted server will run on port 3000.

You can change the port by opening up the docker-compose.yml file and making a few modifications.
First, find the ports section under gk-enterprise-controller: yaml ports: '3000:3000'

Modify the first 3000 to the desired port For example, to use port 80 change it to:

yml ports: '80:3000'

Gitkraken linux mint

Then update the GITKRAKEN_ENTERPRISE_URL environment variable to use the desired port. Again, for port 80 it would look like: yaml environment: GITKRAKEN_ENTERPRISE_URL: http://localhost:80

Finally, find the GITKRAKEN_ENTERPRISE_URL environment variable in the gk-services section and modify the port. For port 80, this would look like: yaml environment: GITKRAKEN_ENTERPRISE_URL: http://localhost:80

  1. Configure where the GitKraken client releases are stored on your host server.By default the releases folder is set to ./gk-data/release. You can change the location by opening upthe docker-compose.yml file and finding the section under gk-enterprise-controller:

and modifying ./gk-data/release to point to another directory on your host server.

  1. Create the folder specified in the above step on your host server.

  2. Extract release.zip in the folder you created on your host server(releases will always be extracted in this folder).

  3. In the same folder containing the docker-compose.yml file, run the following command:

  • To run this command in the background, use docker-compose up -d instead.
  • Note: If installing in CentOS or RHEL7, you may need to specify the full path to the docker-compose installation. The following commands should allow you to run the docker-compose command successfully:
Gitkraken Linux
  1. Navigate to http://localhost:3000 and complete the setup(the port in the URL should match the port from step 3, if it was changed).