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 (
sshandscp). - Optional:
rsyncon both machines for--rsynctransfers. - A terminal with interactive TTY support for the picker and forms.
- Rust only when installing from source.
- Optional:
moshfor 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.