How to Install GitKraken

There are three steps to success with GitKraken. That's it!

  1. Download GitKraken
  2. Install GitKraken
  3. Use GitKraken

No Git tools are required for GitKraken, so once you’ve run the installer, you can open the app and get going.

It works directly with your repositories with no dependencies—you don’t even need to have Git installed on your system. GitKraken is built with NodeGit, a Git framework that is primarily developed and maintained by members of the GitKraken development team.

Below are platform-specific details on minimum requirements and common issues when things may not go as expected.

Looking for GitKraken Enterprise installation instructions? Then please start in with our Enterprise System Requirements page.


Windows (.exe file)

Install Instructions

Double-click the downloaded executable file, and follow the installation instructions.

Data Location

GitKraken data is stored with your home profile in C:\Users\{user}\AppData\Roaming or %APPDATA%/.gitkraken on older versions.


Mac OS (.dmg file)

  • System requirements: Mac OS X 10.9+ (up to and including OS X El Capitan) / macOS Sierra or later
  • Download

Install Instructions

Double click the downloaded DMG file and when prompted, drag and drop the GitKraken icon to your Applications folder.

Data Location

GitKraken data is stored in /Users/{user}/.gitkraken == ~/.gitkraken.


Linux (.deb, .rpm, and .tar.gz files)

  • .deb system requirements: Ubuntu 16.04 LTS or later
  • .rpm system requirements: RHEL 7+, CentOS 7+, or Fedora 29+

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

.deb

GitKraken has a simple package available for Debian based distributions.

wget https://release.gitkraken.com/linux/gitkraken-amd64.deb
dpkg -i gitkraken-amd64.deb

Or download the file.

.tar

wget https://release.gitkraken.com/linux/gitkraken-amd64.tar.gz
tar -xvzf gitkraken-amd64.tar.gz

Or download the file.

.rpm

wget https://release.gitkraken.com/linux/gitkraken-amd64.rpm
sudo yum install ./gitkraken-amd64.rpm

Or download the file.

Data Location

GitKraken data is stored in /home/{user}/.gitkraken == ~/.gitkraken.

Known issues on Linux

Error with libcurl.so.4

Error: libcurl.so.4: cannot open shared object file: No such file or directory.

Run the following command to address the dependency issue.

sudo apt install libcurl3

Error with libcurl-gnutls.so.4

libcurl-gnutls.so.4: cannot open shared object file: No such file or directory

Run the following command to address this issue.

sudo ln -s /usr/lib64/libcurl.so.4 /usr/lib64/libcurl-gnutls.so.4

Error with libXss.so.1

./gitkraken ./gitkraken: error while loading shared libraries: libXss.so.1: cannot open shared object file: No such file or directory

Run the following command to address this issue.

/usr/bin/dnf whatprovides libXss.so.1
dnf install libXScrnSaver
dnf check-update
dnf upgrade