How to Install GitKraken

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

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

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.


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 and .tar.gz files)

  • System requirements: Ubuntu 12.04 or later

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

Data Location

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

CentOS 6, 7, RHEL, Fedora

GitKraken can be run on certain configurations of CentOS, RHEL and Fedora, but we cannot guarantee it will work with your configuration. Kudos to Linux Hint for outlining some workarounds to help install on these systems!

yum install dnf
dnf install libXScrnSaver
dnf check-update && dnf upgrade

wget https://release.gitkraken.com/linux/gitkraken-amd64.tar.gz
tar -xvzf gitkraken-amd64.tar.gz
sudo rsync -va --delete-after gitkraken/ /opt/GitKraken/
cd /opt/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