Diagnostics and recovery
Environment health
sshnav doctor
A sanitized environment report with key-source metadata omitted.
The report checks application paths, database permissions, ssh, optional local rsync availability, generated-configuration drift, and installed include state. If sshnav.generated no longer matches the database, regenerate it with sshnav generate.
Host chain
sshnav doctor prod-api
A sanitized nested route with two proxy hops and the target.
Saved jump aliases are recursively expanded. Each proxy and the final target receives a short TCP connection attempt. DNS failures and connection errors are displayed per hop.
Automatic reconnect
Enable reconnect for a host:
sshnav host edit prod --auto-reconnect
Reconnect is deliberately narrow. sshnav retries only when SSH exits with transport status 255 after a session lasted at least 30 seconds. It makes at most three attempts with delays of 1, 2, and 4 seconds. Authentication failures and short-lived command failures are not retried.
Disable it with:
sshnav host edit prod --no-auto-reconnect

