Support
Get help
Email [email protected]. Tell us your device, the app version (Settings › About), whether the computer runs herdr or Herdr Core, and the exact message you see. Testers can also send feedback with a screenshot from the TestFlight app.
Please don't include passwords, private keys or tokens.
What you need
- An iPhone or iPad with iOS or iPadOS 18 or later.
- A Mac or Linux computer running herdr (or Herdr Core, the herdr project's standalone
hcruntime), with an OpenSSH server on. On a Mac: System Settings › General › Sharing › Remote Login. - A way to reach it: the same local network, a Tailscale, ZeroTier or EasyTier network, or an SSH jump host.
Native Windows computers running herdr are supported too and are added by hand. Herdr Pocket does not run Agents on the phone or host them for you.
Frequently asked questions
How do I add my computer?
Open Hosts, tap +, and choose Connect a Computer for a Mac or Linux computer on Tailscale, or Add Host to type its address as you would after ssh. Confirm the fingerprint and the app adds its key and finds herdr or Herdr Core. If neither is installed, Install for Me runs the installer.
The app says it can't reach my computer.
- Check that Remote Login (or the SSH server) is on and the computer is awake.
- Allow Herdr Pocket in iOS Settings › Privacy & Security › Local Network.
- Away from home, make sure the phone and the computer are on the same overlay network.
- If you changed your tailnet's access rules, let the phone reach the computer on port 22.
It says the computer uses Tailscale SSH.
Tailscale SSH takes over port 22 and ignores the phone's key. On the computer run tailscale set --ssh=false, turn on Remote Login, and try again.
The key was added, but the computer didn't accept it.
On the computer run chmod go-w ~ ~/.ssh, then tap Add Key again.
The password doesn't work during Connect a Computer.
Use the short account name and the password you log in to the computer with, not your Tailscale password. After three tries the computer may not allow password sign-in: tap Run a Command Instead. The password is used once and never saved.
The fingerprint changed.
The computer may have been reinstalled, or someone may be intercepting the connection. The app stops. Check the fingerprint on the computer itself before you continue.
There is no Show Chat for my Agent.
Chat works for Claude Code, Codex, Pi, Oh My Pi, Grok Build and OpenCode on macOS and Linux computers running herdr, and appears once the computer connects. If Chat waits for a conversation, send the Agent a first prompt, check herdr integration status on the computer, then tap Check Again. For OpenCode the computer needs sqlite3 or python3.
On Fedora or RHEL, connections fail even though SSH works.
SELinux can block the SSH session from opening herdr's socket even when forwarding is allowed. A small local policy module allows it; email us and we'll send the steps.
Do I get push notifications?
Not in this beta. We don't operate a push relay, so alerts only appear while the app is open. See the privacy policy.
How do I remove a phone's access to a computer?
Each phone's line in ~/.ssh/authorized_keys ends with its name, such as herdrpocket-iphone-3fa91c. Delete that line on each computer. If you used Tailscale, remove the device in its admin console too.