Fix fetch and push issues

GitButler uses your system Git executable to communicate with remotes. If pushing or fetching fails, check that your system Git can authenticate with the same remote.

Configuring the auto-fetch frequency

GitButler will periodically fetch from your configured remotes in order to display new branches etc. By default, this happens every every 15 minutes.

You can configure the interval or completely disable this behavior by editing the application's settings.json file:

The file is in JSONC format and follows the following schema

  "fetch": {
    "autoFetchIntervalMinutes": 15
  }

A negative value (e.g. -1) disables auto fetching. Note that if fetch is the only entry in the JSON file, you may want to enclose it in a top-level object.

Check Git authentication

GitButler no longer provides separate authentication modes for selecting an SSH key or credential helper. Configure authentication for your system Git instead:

1. In the repository, run git fetch from your terminal.
2. If it fails, fix your Git authentication. Configure SSH through your SSH agent and ~/.ssh/config, or configure an HTTPS credential helper.
3. In GitButler, open the project's settings, go to the Git section, and select Test credentials.

SSH keys managed by tools such as 1Password or backed by a FIDO security key work when they are available to your system Git through the SSH agent.

Get more help

If system Git can fetch and push but GitButler still fails, share the error and your GitButler logs in our Discord.