Install

sshelf runs on macOS and Linux, x86_64 and arm64. The prebuilt packages need no Rust toolchain; at runtime sshelf wants OpenSSH 8.4+ on your machine (password auto-supply rides on SSH_ASKPASS_REQUIRE, added in OpenSSH 8.4 — see the FAQ if unsure).

Homebrew (macOS or Linux)

brew install max-rh/tap/sshelf

Shell installer

Downloads the prebuilt binary for your platform:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/max-rh/sshelf/releases/latest/download/sshelf-installer.sh | sh

Debian / Ubuntu (`.deb`)

Grab the .deb for your architecture from the latest release, then:

sudo apt install ./sshelf_*_amd64.deb      # or *_arm64.deb

Fedora / RHEL / Rocky / openSUSE (`.rpm`)

The .rpm is a static build, so one package runs on any RPM distro regardless of glibc. Grab it from the latest release, then:

sudo dnf install ./sshelf-*.x86_64.rpm     # or .aarch64.rpm

Gentoo

Via the community-maintained Masterwolf overlay (unofficial; thanks to @masterwolf-git):

eselect repository enable masterwolf
emerge --sync
emerge --ask app-admin/sshelf

Cargo (crates.io)

Needs Rust 1.88+:

cargo install sshelf

After installing

Shell tab-completion (subcommands + flags) ships with every package — open a new shell (or exec $SHELL) so it loads. Completion of your saved host names takes one more line in your shell rc: see Shell completions.
On Linux, secrets use the Secret Service (GNOME Keyring / KWallet) through a pure-Rust backend — no libdbus or OpenSSL packages needed. On a headless box with no keyring, see the age vault.
Next stop: the Quickstart.

Keyboard shortcuts

sshelf