GitKraken Desktop Documentation

Push, Pull, and Fetch in GitKraken Desktop

Last updated: January 2026

Push, pull, and fetch operations are essential for synchronizing local work with remote repositories in GitKraken Desktop.


Add a Remote

To add a remote:

  1. Hover over Remote in the Left Panel.
  2. Click the icon.
  3. Enter the remote URL or choose from integration-based dropdowns (GitHub, GitLab, Bitbucket).
Add Remote dialog in GitKraken Desktop with GitHub selected
Add a remote from the Left Panel

Note: Integration dropdowns show forks only. For non-fork remotes, use the URL option.

Remote icons in the Commit Graph:

  • GitHub
  • Bitbucket
  • GitLab
  • Azure DevOps
  • Other

Push Changes

To push local commits to a remote branch:

  • Click Push in the main toolbar
  • Or right-click a branch and select Push
Push button in GitKraken Desktop toolbar
Push a local branch to its upstream

If a remote branch doesn’t exist yet, GitKraken will prompt you to name and create it.

Caution: If fast-forwarding fails, GitKraken may offer a Force Push option. Use with care.

Drag and Drop Push

Drag a branch onto a remote branch (in the graph or Left Panel) to trigger a push.

GitKraken Desktop showing drag-and-drop to push main branch to origin
Drag to push a branch to a remote

Fetch

Fetching retrieves updates from remotes but doesn’t change your working directory.

GitKraken Desktop pull dropdown menu showing fetch and pull options, with the fetch option highlighted.
Fetch from the pull dropdown menu

Fetch All

Shows how far ahead/behind your branches are compared to the remote.

GitKraken Desktop Left Panel showing branch main is 1 commit behind
Ahead/behind indicators in the Left Panel

Fetching runs automatically every minute. Adjust the interval in Preferences > General.


Pull Options

Pulling performs a fetch and then updates your local branch.

Pull (fast-forward if possible)

Fast-forwards your branch if there are no conflicting commits; otherwise, merges.

GitKraken Desktop commit graph showing fallback to merge when fast-forward pull is not possible
Example: Merge fallback when fast-forward not possible

Pull (fast-forward only)

Attempts to fast-forward. If not possible, no action is taken.

Pull (rebase)

Temporarily stashes your commits, pulls from remote, and replays your changes on top.

GitKraken Desktop commit graph demonstrating linear history using pull-rebase
Rebase keeps commit history linear

Set Pull Behavior

Select a default pull method via the dropdown menu.

GitKraken Desktop pull menu with option to set default pull behavior
Choose a default pull behavior

Set Upstream Branch

The upstream defines the remote branch a local branch tracks.

  • Right-click a branch to set its upstream
  • Or click the button
GitKraken Desktop context menu with 'Set Upstream' option selected
Set the upstream branch

You can also drag and drop to push instead of explicitly setting the upstream:

GitKraken Desktop interface showing a user pushing a branch to origin/main using drag-and-drop
Push without setting upstream via drag-and-drop
Have feedback about this article? Did we miss something? Let us know!
On this page