Skip to main content

Three-minute quickstart

1. Add a host​

Use the guided terminal form:

sshnav add

Or add the same host non-interactively:

sshnav host add \
--alias prod \
--hostname 10.0.0.10 \
--user ubuntu \
--identity-file ~/.ssh/prod

The identity is validated, encrypted, and copied into sshnav's SQLite database. The source path remains metadata so doctor can explain where the key originated.

2. Open the picker​

sshnav

Start typing to fuzzy-filter the inventory. Press Enter to connect.

KeyAction
↑ / ↓Move through results
EnterConnect
Ctrl+AAdd a host
Ctrl+EEdit the selected host
Ctrl+DDuplicate the selected host
EscExit

3. Connect directly​

The picker is optional. Every host is addressable by alias:

sshnav connect prod

sshnav constructs an argument vector and launches ssh directly. It never interpolates the connection into a shell command.

4. Transfer a file​

sshnav send prod ./release.tar /srv/releases/
sshnav receive prod /var/log/app.log ./logs/

Add -r or --recursive for directories. Transfers reuse the host's user, hostname, port, options, jump route, and encrypted identity.