Herald help and troubleshooting
Most problems come down to the phone and the computer not seeing each other. Start with the symptom you see; each page lists the checks in order.
- “Couldn’t reach” your Hermes: fix Herald connection problemsHerald says it couldn’t reach your Hermes Agent? Check that hermes serve is running, that phone and computer share a network or tailnet, and the saved address.Reviewed 20 October 2026
- Signed out, or stuck on 401: sign Herald back in to HermesHerald signed out, or every request fails with 401? Your Hermes dashboard password changed or the session expired. How to sign back in without losing chats.Reviewed 20 October 2026
- My bot list is empty: find your Hermes Agent bots in HeraldConnected to Hermes Agent but Herald shows no bots, or not the ones you expected? Check filters, the profile’s gateway, and which Hermes home you paired with.Reviewed 20 October 2026
- Push notifications never arrive: set up hermes-bot-pushNo push from Herald when a Hermes Agent bot finishes or needs approval? Check the hermes-bot-push plugin, a real phone, Register and Send a test push, in order.Reviewed 20 October 2026
- Creating a bot with a custom model failsHerald created the bot but left it on your default model? Custom-provider models only carry over when that provider backs your default model. Here are the fixes.Reviewed 20 October 2026
- Tailscale address not working: fix HTTPS access to HermesHerald can’t reach your Hermes over its Tailscale ts.net name? Check Tailscale on both devices, HTTPS certificates, Tailscale Serve and dashboard.public_url.Reviewed 20 October 2026
- “Invalid username or password” and other Hermes sign-in errorsHerald can’t sign in to your Hermes Agent? How token and password modes work, what dashboard.basic_auth needs, and why a dashboard with only OAuth won’t work.Reviewed 20 October 2026
- Hermes gateway not running: why schedules, kanban and bots stallScheduled jobs not firing, kanban cards stuck in Ready or bots missing in Herald? The Hermes Agent gateway may be stopped. How to check it and start it again.Reviewed 20 October 2026
Get Herald for Hermes Agent
iPhone, iPad, Apple Watch, CarPlay and Android. $12.99 once, no subscription, no account and no Herald server.
Herald is an independent, unofficial app. It is not made, endorsed or supported by Nous Research.