Navigate to Preferences to customize your GitKraken Client experience. Here are what each of the major sections do.
This section will actually be labeled with your organization name rather than "Organization". It shows the members and teams within your organization. Click
switch organization to swap to another organization.
The Owner and any Admins are able to:
- Change role of members within the organization
- Invite members to the organization and purchase licenses
- Create and manage teams
Note: the Organization section is only availibe to users who have a Pro or Enterprise license.
Set the number of minutes between auto-fetches. This value must be between 0 and 60 minutes, and it will fetch all visible remotes for the repository. Setting the value to 0 minutes will disable auto-fetch.
If you’re experiencing issues with performance, consider setting your auto-fetch value to 0 and restarting the application.
Removes any remote-tracking references that no longer exist on the remote.
Default Branch Name
Set the default name when initializing a new repo. The app defaults to
External Merge Tool
This is where you may set your preferred external merge tool.
External Diff Tool
There is where you may set your preferred external diff tool.
You may open a repo in your preferred external editor program using the Command Palette. Supported editors include:
- VS Code
Delete ".orig" files
GitKraken Client will make .orig files during a merge. If turned off, these before and after files will not be automatically deleted.
You may open the current repo folder in terminal by navigating to File > Open Terminal or use the keyboard shortcuts opt + T (Mac) / alt + T (Windows + Linux).
Set your preferred terminal from this preference option for this action.
Use Custom Terminal Command
Enables the option to specify a custom command to open a terminal window.
For example, to set up GitKraken Client to open Powershell 7, use the command
start "" "C:Program FilesPowerShell7pwsh.exe" -noexit -command "cd %d"
Show All Commits in Graph
Enabling this option will force GitKraken Client to always show all commits in repo. This setting may cause performance issues with large repositories.
Max Commits in Graph
Set the max number of commits GitKraken Client will show in the graph. Lower counts may help improve performance, and the minimum value is 500 commits.
This will remember open tabs when you quit GitKraken Client. This option will also remember what tabs you have open for each profile.
Longpaths (Windows Only)
For Windows users, GitKraken Client will respect the
core.longpaths setting in the global .gitconfig. Adjusting this setting will change
core.longpaths in your .gitconfig.
core.longpaths only applies to the files in the working directory, not in the .git directory, to maintain compatibility with Git for Windows.
AutoCRLF (Windows Only)
For Windows users, GitKraken Client will respect the
core.autocrlf setting in the global .gitconfig. Adjusting this setting will change
core.autocrlf in your .gitconfig. Enabling this option auto-converts CRLF line endings into LF when adding a file to index, and vice versa when checking out code onto your file system. For more information check out this git documentation
Use extended logging in activity log
Provides more information for the activity log. You may access the activity log from Help > Support Logs > Activity Logs.
Forget all Usernames and Passwords
Removes credentials that currently stored by GitKraken Client.
Share work-in-progress status with my team
Allows other users in your team to see your local work in progress files. This is directly related to the Teams feature.
GitKraken Client uses profiles to store your app preferences, current Tabs, and Git config information.
SSH & Integrations
GitKraken Client supports HTTPS and SSH authentication, and provides useful integrations with many Git hosting services. Here’s how to get started.
- General SSH settings
- GitHub Integration
- GitHub Enterprise Integration
- GitLab Integration
- GitLab Self-Managed Integration
- Bitbucket Integration
- Bitbucket Server Integration
- Azure DevOps Integration
- TFS, AWS CodeCommit, custom service, etc
- Jira Cloud Integration
- Jira Server Integration
GitKraken Client’s notification system is designed to tell you about updates, bug fixes, product tips, and more. The following preferences are available:
- Enable Desktop Notifications
- Receive Marketing Notifications
- Receive Help Notifications
Note: Marketing notifications can only be disabled by Pro users.
The following UI preferences are available:
- Notification location
- Show toolbar icon labels
- Enable spell checking
- Display author initials instead of avatars (Gravatar)
- Show ghost branch/tag when hovering over or selecting a commit
- Highlight associated rows when hovering over a branch
- Show Workspace breadcrumb in toolbar
- Show GitKraken Boards button in toolbar
- Show GitKraken Timelines in toolbar
- Show commit author in graph
- Show commit date/time in graph
- Show commit sha in graph
Learn more about how to configure GPG signing in GitKraken Client.
Customize the following settings for your GitKraken Client editor and diff:
- Font size
- Tab size
- End of line character
- Syntax highlighting
- Show line numbers
- Word wrap
These settings only effect
- Font Size
- Enable Autocomplete Suggestions
- Show Graph Panel by Default
- Terminal Theme
- Default Terminal (Windows only)
Repo-Specific preferences only apply to the repo currently open in GitKraken Client. The following preferences are repo-specific:
You may configure unique repo-specific settings for each repo.