Delete your Herald account and data

Herald accounts, in short

This page is for Herald, the app for iPhone, iPad, Apple Watch and Android, developed and published by lukethedev. It explains how to delete your Herald account and data.

Herald has no accounts of its own: there is no sign-up and no Herald password, and no Herald server holds your chats. What Herald does create is your X link on our relay (if you linked X), this device’s push registration and sign-in sessions on each Hermes you connected, and the data it keeps on the device. Deleting your account removes all of it.

Delete your account in the app

Open Herald and go to Settings › General › Account.
Tap Delete account, read what will be deleted, and confirm.
Herald deletes your data, shows a confirmation and returns to the welcome screen. Delete the app afterwards if you no longer want it.

Delete account is in Herald 3.0.8 and later. In an earlier version, unlink X under Settings › General › X, tap Remove under Settings › General › Push notifications, remove your saved connections and then delete the app, or update Herald first.

What is deleted

Data	Where it is	What happens
Your X link: your numeric X user id, every linked phone’s push token and link secret, and any requests waiting for your phone	Herald’s X relay, on Cloudflare	Deleted straight away
This device’s push registration (push token, device name, install id and Live Activity tokens)	Each Hermes you connected	Removed, so your Hermes stops sending banners to it
Sign-in sessions	Each Hermes you connected	Signed out
Connections, passwords and tokens, cached chats and media, voice notes, AI data sharing choices and settings	This device	Erased

What is kept, and for how long

Data	Why	How long
An opt-out marker on the relay: your X user id and the time	So your “stop” stays honoured and you are never invited	No expiry. We remove it on request; without it the relay could invite that account again
An invite marker on the relay, only if @HeraldHermes invited you before you linked	So nobody is invited twice	Up to 365 days
Short-lived relay records: a marker that stops an earlier sign-in from linking again, request counters, a confirmation still owed, and the last confirmation line you got	To finish or block work already in progress	They expire on their own within 30 days
Your Hermes dashboard login, and the chats, bots and files on your Hermes	They are on your own computer and were never ours, so Herald doesn’t delete them	Until you delete them, as described in the next section
Content your Hermes already sent to its AI model, speech or image providers	Held by those providers under your account with them	Under each provider’s own terms; delete it with them
Messages you sent us through the support form	To answer you	Deleted no later than 90 days after your request is resolved, or sooner if you ask
Your purchase	Held by Apple or Google, not by us	Under the store’s own policy. Deleting doesn’t refund the purchase, and you can download Herald again

Copies in your device backups follow your operating system’s backup settings.

Delete your Hermes login and chats on your computer

The dashboard login

npx herald-setup created your Hermes dashboard login on your computer, in ~/.hermes/config.yaml under dashboard.basic_auth, and, for an address reached through Tailscale or a proxy, set dashboard.public_url. To delete it:

If herald-setup published Hermes on your tailnet, stop that first: tailscale serve --https=443 off.
Open ~/.hermes/config.yaml (or the config.yaml of the Hermes profile you use) in a text editor. Under dashboard:, delete the basic_auth: block and the public_url: line, then save. If you set any HERMES_DASHBOARD_BASIC_AUTH_ variables in Hermes’ .env, remove them too.
Restart Hermes: run hermes serve --stop, then hermes serve (or restart the Hermes service or container that runs it).

Without a login, Hermes serves its dashboard only to the computer itself, because it refuses to serve one on any other address without a login. Herald can’t connect again until you run npx herald-setup again. To replace the password instead of deleting it, run npx herald-setup --reset-password, which also signs out every device.

Chats and bots

Your chats are sessions on your Hermes, and each bot is a Hermes profile. Delete them with Hermes’ own tools, in the Hermes dashboard or on the command line:

hermes sessions list shows your sessions and their ids, and hermes sessions delete <session id> deletes one. Close the chat first, or its next save recreates it.
hermes sessions prune --older-than 30 deletes ended sessions older than 30 days. Pinned and archived sessions are kept unless you add --include-pinned or --include-archived.
hermes profile delete <name> deletes a bot with all its configuration, memories, sessions and skills. The default profile can’t be deleted; hermes uninstall removes Hermes entirely.

See the Hermes Agent documentation for details. Content your Hermes already sent to an AI provider is deleted with that provider.

Delete your data without the app

Your X relay data. From your X account, post “@HeraldHermes stop”. The relay unlinks every phone and deletes your link, push tokens and waiting requests, as Delete account does, usually within a minute. The opt-out marker and the records above are kept as described.
Your Hermes login, chats and push registration. They are on your computer: follow the steps above. Removing or replacing the dashboard login signs every device out.
Data on a device you no longer have. Herald keeps it only on that device. Erasing the device or deleting the app removes it, and changing your Hermes password (above) stops the device from signing in.
Anything else, or the opt-out marker. Send us a privacy request through our support form with your X username if it’s about X. We may ask you to confirm from that X account.

Ask for help

Use our support form and choose Privacy request. Tell us what you’d like deleted. We respond within 30 days. The privacy policy explains everything Herald collects and who it is shared with.

Questions about this page?

Send us a message through the support form and we’ll get back to you.