HerdRanger 0.20.18 pre-release guide

02 · Secure SSH setup

Give the phone only the access it needs.

Choose a password or phone-generated key, preserve recovery access, and carry ordinary OpenSSH over a private network.

Open the user guide

Choose an SSH credential

Password saves the SSH account password in encrypted local credential storage. For an eligible profile, the terminal’s key control can send the password once to a prompt you have reviewed.

Generate Ed25519 key makes a key on your phone. Copy only the public key to the intended account. The private key stays in encrypted app storage and can be included in a password-encrypted backup you explicitly create.

Supported OpenSSH key records can also be restored from an authenticated encrypted backup. Check the available credential actions on your build before planning a migration.

Install a generated public key

  1. Add the profile and keep Generate Ed25519 key selected.
  2. Save the profile.
  3. Choose Copy public key. This copies only the OpenSSH public-key line.
  4. Using an existing trusted administrative path, append it as one new line in the intended account’s ~/.ssh/authorized_keys.
  5. Preserve existing keys and apply safe ownership and permissions.
  6. Test the new login before disabling any prior access method.

Keep an independent recovery key or account. Verify the host fingerprint before relying on the new key.

Verify the host and keep recovery access

Install the public key through a trusted administrator session. Verify the server’s SHA-256 host fingerprint through a separate trusted channel before accepting it in HerdRanger. If a previously trusted key changes, authentication is blocked. Verify the cause independently before re-establishing trust.

Keep your existing key or administrator access until you have verified the new login.

Use one stable private address

For a profile that must work at home and away, use a Tailscale MagicDNS name (opens in a new tab), Tailscale 100.x address, NetBird peer address (opens in a new tab), or another approved private-VPN hostname. Allow ordinary OpenSSH on TCP 22 with the narrowest practical policy.

HerdRanger stores one endpoint and does not silently fall back to another. Do not expose SSH or the Herdr socket (opens in a new tab) publicly as a shortcut.

Use standard OpenSSH. Tailscale SSH and NetBird SSH use separate authentication models and have not been validated for this HerdRanger flow.

Supported and unsupported methods

Generated keys use Ed25519. Supported saved OpenSSH key types include Ed25519, RSA, and ECDSA. This build does not support legacy PEM/PKCS8, PuTTY, DSA, SSH certificates, agent forwarding, keyboard-interactive MFA, or trust-all host verification.

Avoid changing sshd_config just for HerdRanger. Do not globally enable password login, disable host-key checking, or create broad AllowUsers or sudo rules without understanding their effect.