Skip to content

Installation

Jump to bottom
Mehdi edited this page Sep 2, 2026 · 4 revisions

Installation

SSH Pilot is available for all major Linux distributions and macOS. Choose the method that works best for your system.

Ubuntu / Linux Mint / Pop!_OS (PPA)

The recommended way for Ubuntu-based distributions. This gives you automatic updates.

sudo add-apt-repository ppa:mfat/sshpilot
sudo apt update
sudo apt install sshpilot

Step by step:

  1. Open a terminal
  2. Copy and paste the first line (sudo add-apt-repository...) and press Enter
  3. Enter your password when prompted
  4. When asked to confirm, press Enter again
  5. Copy and paste the second line (sudo apt update) and press Enter
  6. Copy and paste the third line (sudo apt install sshpilot) and press Enter
  7. SSH Pilot is now installed -- find it in your application menu

Debian (APT Repository)

For Debian users who want automatic updates.

Step 1 -- Add the GPG key:

curl -fsSL https://mfat.github.io/sshpilot-ppa/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/sshpilot-ppa.gpg

Step 2 -- Add the repository:

echo "deb [signed-by=/usr/share/keyrings/sshpilot-ppa.gpg] https://mfat.github.io/sshpilot-ppa any main" | sudo tee /etc/apt/sources.list.d/sshpilot-ppa.list

Step 3 -- Install:

sudo apt update
sudo apt install sshpilot

More info: https://mfat.github.io/sshpilot-ppa/

Fedora / RHEL / CentOS Stream (COPR)

For RPM-based distributions.

dnf copr enable mahdif62/sshpilot
dnf install sshpilot

Step by step:

  1. Open a terminal
  2. Run sudo dnf copr enable mahdif62/sshpilot and confirm when prompted
  3. Run sudo dnf install sshpilot
  4. SSH Pilot is now installed

Flatpak (All Linux Distributions)

Flatpak works on any Linux distribution that supports it. This is the recommended option if your distribution is not listed above.

flatpak install flathub io.github.mfat.sshpilot

Or install it graphically from Flathub.

Note: The Flatpak version runs in a sandbox. Some features like external terminal integration may behave slightly differently.

Arch Linux (AUR)

For Arch Linux and derivatives (Manjaro, EndeavourOS, etc.).

Stable release:

yay -S sshpilot

Nightly build (latest changes):

yay -S sshpilot-git

Replace yay with your AUR helper of choice (e.g., paru).

macOS

SSH Pilot supports macOS 14 (Sonoma) and later.

Option 1 -- Homebrew

brew tap mfat/sshpilot
brew install sshpilot

This installs all required GTK4 dependencies automatically. The first install may take a few minutes as it compiles dependencies.

Option 2 -- DMG Installer (Recommended)

  1. Go to the Releases page
  2. Download the .dmg file for your architecture (aarch64 for Apple Silicon, x86-64 for Intel)
  3. Open the DMG and drag SSH Pilot to your Applications folder
  4. Launch SSH Pilot from your Applications folder

macOS Notes

  • On macOS, SSH Pilot uses the VTE terminal backend (PyXterm.js is not available on macOS)
  • You may need to allow the app in System Settings > Privacy & Security on first launch and after each update.

Next step: Quick Start -- Make your first connection

Clone this wiki locally