HerdRanger 0.20.18 pre-release guide

01 · Get started

Connect to your first server.

Choose Herdr Core, legacy Herdr TUI, or a standard SSH shell. All three start with a verified SSH connection.

Open the user guide

Before you begin

  • Android 9 or later with HerdRanger installed.
  • A reachable SSH server you own or are authorized to administer.
  • A standard OpenSSH account using a password or supported key, and a host fingerprint you can verify independently.
  • A trusted recovery path. A private network or VPN can provide reachability without exposing SSH publicly.

Prepare the host for your mode

Herdr Core

Set up the Herdr desktop app and a compatible Core runtime on your host. The same account you use for SSH needs access to the running Core runtime. Open the saved Core profile to discover existing work. Desktop spaces and tabs appear where the connected runtime exposes them.

If the runtime cannot be reached, sign in as the same SSH user and run hc server status using the Core executable from your installation.

Herdr TUI

Sign in with the same account you will use from Android and check the existing legacy Herdr installation. The legacy integration targets protocol 22 and schema 1 and checks the capabilities reported by the host.

herdr status
herdr session list --json
herdr api schema --json

Use the host’s normal workflow if you need to start the runtime. Keep its local API private.

SSH

Verify that the account can open a standard SSH shell. File tools also need an SFTP subsystem and the relevant file permissions. Herdr and agent providers are optional on this host.

Add a server profile

  1. Open Servers, select Herdr Core, Herdr TUI, or SSH, then choose Add.
  2. Enter the display name, SSH host, port, and username. Choose an existing credential or configure a password or generated Ed25519 key.
  3. Save the profile. Use Test connection or open the server and verify its fingerprint when prompted.

Saved server cards use the available width on phone and wider layouts. Use Edit to update a profile, Clone to make a separate profile with an explicitly selected mode and credentials, or Remove and review the confirmation.

See Secure SSH setup for key installation and private networking.

Servers screen with Herdr Core, Herdr TUI, and SSH tabs above the Add Herdr Core server button.
The Servers screen on a fresh installation.

Verify the SSH host fingerprint

The first connection shows the server’s SHA-256 SSH host-key fingerprint. Compare it with a value obtained independently from the host or its administrator. Choose Trust only when it matches.

If the host key changed, stop. A rebuild or restore may explain a change, but interception can also cause it. HerdRanger blocks changed keys and has no trust-anyway override.

Test the connection and open your work

The read-only test checks SSH and the service selected for that profile. Discovery and reconnect leave runtime installation, startup and upgrades to explicit actions. The app stays in the selected mode.

Open a Core space or agent, select a running TUI session if prompted, or open an SSH shell. Provider installation and sign-in are separate host-side steps.

Continue to Sessions, spaces, and agents for Herdr workflows or Terminal and files for standalone SSH.