From first connection to confident daily use.

HerdRanger is an independent Android (opens in a new tab) companion for Herdr (opens in a new tab). This guide covers the complete setup and operating workflow for a host you own or are authorized to administer.

Start here Troubleshoot a problem

Documentation reviewed October 10, 2026 against the HerdRanger 0.10.0 application, source guide, and Herdr 0.9.0 / protocol 22.

Complete guide

Choose the task in front of you.

01Get startedPrerequisites, add a host, verify its fingerprint, test the connection, and recover from first-connection failures. 02Secure SSH setupPassword and generated-key setup, trusted-agent request, private-network access, and recovery planning. 03Sessions, spaces, and agentsManage sessions, open discovered projects, understand spaces, and follow the adaptive agent layout. 04Agents and mobile workflowRead status, review bounded output, respond to approvals, send safely, and understand local history. 05SSH terminal and filesUse the general shell or direct agent terminal deliberately, control input, and understand transfer boundaries. 06Monitoring and notificationsChoose periodic or live monitoring, understand Android limits, open alerts, and protect notification privacy. 07Voice and accessibilityReview speech before sending, manage provider boundaries, and use TalkBack, large text, rotation, and fold layouts. 08Settings and backupsPersonalize display and sound, protect credentials, export profiles, and create encrypted device backups. 09Troubleshooting and limitationsUse symptom-first recovery without unsafe retries, and prepare a privacy-safe support report. 10Privacy, security, and licensesFollow the data path, understand security limits, review third-party components, and find legal notices.

Connection model

Your phone connects directly to your host.

Android phoneYour hostHerdr

HerdRanger is not a hosted service or cloud relay. Your provider login, API credentials, project files, Herdr process, and terminal output remain governed by your host and device.

Keep secrets out of support. Never submit passwords, private keys, pairing codes, backup passwords, server addresses, terminal output, screenshots containing secrets, transcripts, or agent output through the public support form.

Herdr remains the source for Herdr itself.

This guide explains HerdRanger. For installing and operating Herdr, use the maintainers’ documentation.

Official Herdr documentation Herdr source