Skip to content

Install ​

BranchPilot 1.0.0 is available for Linux on 64-bit Intel and AMD computers. Pick one of the three ways below. If the package types are new to you, read Installing apps first.

Before you install ​

The .deb and PPA packages run the git command that is installed on your computer, and need Git 2.28 or newer. Check with:

bash
git --version

If Git is missing, install it with your distribution's package manager, for example sudo apt install git on Ubuntu or Debian. The PPA package installs Git for you if needed.

The snap carries its own copy of Git, because a sandboxed app cannot run the one on your system. You still want Git on your system to clone or create repositories in a terminal.

Choose a package ​

PackageUse it when
.deb or PPAYou want BranchPilot to use your global Git settings, credential helpers and ssh-agent exactly as your terminal does.
SnapYou want automatic updates from the Snap Store and accept the sandbox limits described below.

Install the .deb ​

  1. Download branchpilot_1.0.0_amd64.deb from the releases page.

  2. Install it:

    bash
    sudo dpkg -i branchpilot_1.0.0_amd64.deb
  3. Start BranchPilot from your application menu, or run branchpilot in a terminal.

Install from the PPA (Ubuntu 24.04) ​

The Dhiva Labs PPA carries BranchPilot for Ubuntu 24.04 (amd64). Updates then arrive with your normal system updates.

bash
sudo add-apt-repository ppa:dhiva-labs/apps
sudo apt update
sudo apt install branchpilot

Install the snap ​

bash
sudo snap install branchpilot

The snap is strictly confined, which means it runs in a sandbox. Two things work differently because of that.

SSH remotes need one extra command. Give the snap access to your SSH keys once after installing:

bash
sudo snap connect branchpilot:ssh-keys

Your global Git settings are not visible. A confined snap cannot read hidden files at the top of your home folder, so it does not see ~/.gitconfig. Set your name and email inside each repository instead. In a terminal, in the repository folder:

bash
git config user.name "Your Name"
git config user.email "you@example.com"

Your repositories themselves are fully accessible to the snap. Only the top-level hidden files are not.

TIP

If you rely on a credential helper or a global Git configuration, the .deb or PPA package is the smoother choice. It is not sandboxed.

Check that it works ​

Start BranchPilot. You see the welcome screen with the app name, the line A git client for Linux and an Open repository… button. Continue with the beginner guide.

Uninstall ​

bash
sudo apt remove branchpilot     # .deb or PPA
sudo snap remove branchpilot    # snap

Uninstalling BranchPilot does not touch your repositories.

Next steps ​