General Troubleshooting for GitKraken Client 9.4.0+
In 9.4.0, GitKraken introduced the experimental feature for the Git Executable. As this is currently an experimental feature that our team is continuing to improve on, you can try adjusting your use of the Git Executable.
Preferences > Experimental, first try adjusting the
Git Executable version used. If you are using the “Bundled with GitKraken” version (comes pre-installed with GitKraken) try changing this to your own version of Git. If you do not have this installed, it can be downloaded here.
The reason this may help is because the Bundled version is a minimal install of Git, which does not include all features (specifically bash programs that may be used in Git Hooks).
If using your own version does not resolve the issue, try unchecking
Use Git Executable.
If this does resolve your issue, it is very important to note that GitKraken Client is transitioning all actions to the Git Executable (from LibGit2/nodegit) and the Git Executable will become the exclusive way GitKraken Client performs Git operations in a future release.
As such, it is crucial for our team to be made aware of any issues related to using the Git Executable so we can look into and address them. Please reach out to our support team if you experience any issues with using this Experimental feature.
For more information on what this feature is and why it is being implimented, you can check out this blog post.
Integration – 1000 Error (1002, 1003, 1005, 1007)
When attempting to connect to one of our integrations, you may see
Error 1005 or
These are general authentication errors. First, verify you used the correct credentials then try one of the following potential solutions:
If your credentials are correct, you can try signing out of the service in your default browser first, and then attempting the authentication from GitKraken Client again.
Clear your browser cache, sign out of the git hosting service, then restart GitKraken Client and try again.
If that is not working you can also try changing your operating system default browser to be a different browser. Once this is changed you can restart GitKraken Client and attempt to authenticate again.
If that still does not work, please contact our support team and we can troubleshoot further.
Error when pushing a branch
When attempting to push a branch, you may see the following
Push Failed: Cannot read property 'fullName' of undefined error:
This usually indicates that there is a casing difference between the local branch and the upstream remote branch. You can rename the local branch to match the casing of the upstream remote branch, which will allow you to push the changes.
Note: You may need an intermediate name change to get the branch named correctly. For example: Test-branch > temp-name > test-branch
Some branches or files not appearing – Capitalization issue
This most often occurs when having multiple remote banches nested together, but the capitalization differs. For example:
feature/foo may either be detected as the same branch OR a different branch depending on how your operating sytem treats capitalization. Most often this appears on Windows machines.
- Branches not appearing in GitKraken – only one of the branches will be detected when they share a name.
- This can also apply to files. If two files share the same name with only different capitalization one may appear deleted, moved, or not at all.
- This can also manifest as the file being staged but not showing as staged when running a
To avoid these capitalization issues, we recommend giving each branch, file, and remote a unique name.
Cannot log in – Cannot read property ’email’ of null
When trying to log in, you may see the following error:
Cannot read property 'email' of null. This is commonly related to a network issue such as a proxy, firewall, or security application. The most common occurrence is something like Zscaler.
If you have any of the above in place try the following:
- Sign in with GitHub authentication
- Approve the GitKraken application
- Continue as free with 0 days
- Click on free icon in bottom right, this brings up a web page inside GitKraken Client which authenticates against Zscaler
- Restart GitKraken Client and authenticate normally
This should allow you to log in without issue.
Windows taskbar icon is not showing the GitKraken logo
Some Windows users are seeing the taskbar icon show incorrectly for GitKraken. This is due to the start menu shortcut moving from
C:\Users\USER\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Axosoft, LLC to
You can delete the old folder
C:\Users\USER\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Axosoft, LLC, start GitKraken from the start menu, and then pin it to the taskbar again to resolve this.
Why can’t I see my GitHub remotes or repositories in the drop down menu? Why am I getting an error about GitHub organization permissions?
In order to work with with a repository owned by a GitHub organization with the GitHub integrtion connected, you need an organization to first allow access.
- First check to see if access is allowed to GitKraken from your profile’s GitHub Applications
- If access has been allowed, then the organization will need to allow Organization Approval
- 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.
- For details about third-party application restrictions view Third-party apps list