Skip to main content

Installation

sshnav runs on Linux and macOS terminals. Connections use the system ssh; transfers use OpenSSH scp by default or optional rsync.

Requirements​

  • OpenSSH client (ssh and scp).
  • Optional: rsync on both machines for --rsync transfers.
  • A terminal with interactive TTY support for the picker and forms.
  • Rust only when installing from source.
  • Optional: mosh for hosts using the mosh template.

Install from source​

git clone https://github.com/Vulcanite/sshnav.git
cd sshnav
cargo install --path . --locked
sshnav --version

cargo install places the binary in Cargo's binary directory, commonly ~/.cargo/bin. Ensure that directory is in PATH.

Debian package​

Download the .deb from the latest GitHub release, then install it:

sudo apt install ./sshnav_0.1.3_amd64.deb

The package declares openssh-client as a dependency and suggests mosh and rsync.

RPM package​

Download the .rpm from the latest GitHub release, then install it:

sudo dnf install ./sshnav-0.1.3-1.x86_64.rpm

Verify the environment​

sshnav doctor

The doctor checks the database location, permissions, OpenSSH programs, generated config, and private-key sources. Fix required failures before importing sensitive identities.

Shell completions​

Generate completion code for your shell with sshnav completions <SHELL>. See the CLI reference for examples.