HerdRanger 0.20.18 pre-release guide

08 · Settings, personalization, and backups

Personalize the app without weakening recovery.

Display settings are local. Credentials stay encrypted. Profile exports and encrypted device backups have deliberately different security boundaries.

Open the user guide

Themes, wallpapers, and sound

Choose System, Dark, or Light theme; Standard, Large, or Extra large text; and Framed or Edge-to-edge presentation in Menu → Settings. HerdRanger also includes 20 bundled wallpapers. A local background can be repositioned by dragging its preview; the app stores only the focal position and does not alter or back up the source image.

The bundled wallpapers are AI-generated HerdRanger assets. Notification sound is selected in Settings → Agent notifications; Android controls final volume, vibration, and interruption.

When available, server cards show battery or uptime in the shared status line, cycling between the two if both are present. The connection status appears when neither is available.

Credentials and HerdRanger Protect

Profiles, host pins, passwords, passphrases and private keys use encrypted app storage. Open Menu → Settings for credential management and Security & privacy to enable optional HerdRanger Protect. It uses Android’s device authentication to lock the app. HerdRanger does not receive your biometric data or device PIN.

Export server profiles without credentials

Profile-only export transfers connection settings without passwords, private keys, passphrases or trusted host fingerprints. A profile file can still contain server and account information. Reassign credentials and verify the fingerprint after importing a profile.

Create an encrypted device backup

This is an explicit export through the Android document picker (opens in a new tab), not automatic device backup.

  1. Open Settings and choose Create encrypted backup.
  2. Select the records to transfer.
  3. Choose a strong password of at least 12 characters.
  4. Save the .hrb file through Android’s document picker.
  5. Keep the backup and password separately.

The backup can contain selected saved servers, credentials, private keys, plans, notes, project roots and hidden-folder preferences. It excludes the Android Keystore key, trusted host fingerprints, HerdRanger Protect, custom wallpaper image, monitoring state and the rebuildable discovery cache.

Treat the file and password together as server access. A forgotten password cannot be recovered by HerdRanger. Do not send a backup through support.

Restore onto a new device

The destination validates and re-encrypts the restored records. Compare SSH fingerprints independently and set up HerdRanger Protect again if wanted. Monitoring state stays with the original device. Verify each restored host while you still have a separate recovery path.

Use the app’s supported export and restore workflow. Vault files are encrypted for their app and device and cannot be moved by copying them between app identities.