Preferences

Navigate to Preferences to customize your GitKraken Desktop experience. Here are what each of the major sections do.

---

Organization

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

General

Auto-Fetch

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.

Auto-Prune

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

External Merge Tool

This is where you may set your preferred external merge tool.

• Supported Merge Tools

External Diff Tool

There is where you may set your preferred external diff tool.

• Supported Diff Tools

External Editor

You may open a repo in your preferred external editor program using the Command Palette. Supported editors include:

• VS Code
• Atom
• Sublime
• IntelliJ

You may also set your preferred external editor from this preference option by going to Preferences > External Tools and selecting <Custom> and entering the path for the editor you want to use. If needed, you can configure the arguments to pass when opening repos or files in your selected editor.

Delete “.orig” files

GitKraken Desktop will make .orig files during a merge. If turned off, these before and after files will not be automatically deleted.

Default Terminal

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 Desktop 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 Desktop 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 Desktop will show in the graph. Lower counts may help improve performance, and the minimum value is 500 commits.

Remember tabs

This will remember open tabs when you quit GitKraken Desktop. This option will also remember what tabs you have open for each profile.

Longpaths (Windows Only)

For Windows users, GitKraken Desktop 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 Desktop 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 Desktop.

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.

Profiles

GitKraken Desktop uses profiles to store your app preferences, current Tabs, and Git config information.

Learn more about Profiles

SSH & Integrations

GitKraken Desktop 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 Server 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 Data Center Integration

Notifications

GitKraken Desktop’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

UI Customization

The following UI preferences are available:

• Theme
• Notification location
• Date/Time Locale
• Date/Time Short Format
• 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

Date/Time Locale and Short Format

Date and Time Locale can be set from the UI Customization to match your system or you can set a custom locale. The Date/Time Short Format will match the Date/Time Locale. However, you can define a custom format as well.

See all formatting options that can be used here.

GPG Preferences

Learn more about how to configure GPG signing in GitKraken Desktop.

Editor Preferences

Customize the following settings for your GitKraken Desktop editor and diff:

• Font
• Font size
• Tab size
• End of line character
• Syntax highlighting
• Show line numbers
• Word wrap

Terminal

These settings only effect Terminal tabs.

• Font
• Font Size
• Enable Autocomplete Suggestions
• Show Graph Panel by Default
• Terminal Theme
• Default Terminal (Windows only)

Experimental

Activate Experimental Features and try out ideas that are still being worked on.

• Git Binary: Use Git executable instead of NodeGit Git actions (partially, not all git actions are implemented to Git executable)
• AI Commit Message Generation

Repo-Specific Preferences

Repo-Specific preferences only apply to the repo currently open in GitKraken Desktop. The following preferences are repo-specific:

• Encoding
• Gitflow
• Git Hooks
• Commit
• LFS
• Issues
• Team
• Submodules

You may configure unique repo-specific settings for each repo.