How-To Series · Episode 06 / 59 · Module 1: Get Running

Updating Hermes · Safely

One command does the pull, the deps, the config migration, and the gateway restart. With a preview mode and a rollback path.

After this videoYou can now update Hermes without losing your config or your running gateway.

hermes update is the whole story. It applies the release, prepares dependencies, prompts for new config options, and restarts running gateways. Source installs track the stable channel (latest published release at its exact commit); --set-channel main follows every commit. --check previews against the selected channel's target without applying code, installing dependencies, or restarting gateways. --backup archives HERMES_HOME first. The updater survives terminal drops (SIGHUP ignored, output mirrored to ~/.hermes/logs/update.log). One gateway per host now owns every local session, so an older release cannot run on a state.db the new gateway wrote: to roll back, stop the gateway, check out the older release, and restore a pre-update snapshot or backup. Validate after with hermes doctor, hermes --version, hermes gateway status, hermes pm status.

About these resources. Every command in this video comes from the Updating doc. The Nix doc is cited only for the Nix-specific update path (nix flake update + nixos-rebuild switch).

New words here · Plain English

one sentence each · full glossary
BackupA saved copy of your setup taken before an update, so you can undo if something breaks.
RollbackPutting the saved copy back. One command returns Hermes to how it was before the update.

Sources · What this video distills

2 docs pages · every command below traces to one of them
Primary · hermes update, --check, --backup, terminal-drop safety, Windows guard, rollback
Updating & Uninstalling
Read ↗
The Nix-specific update path
Nix & NixOS Setup · Updating
Read ↗

Commands shown · Copy and paste

each shows the source doc it came from
Preview only · no changesfrom Updating ↗
hermes update --check
Follow every commit instead of releasesfrom Updating ↗
hermes update --set-channel main
Back to releases onlyfrom Updating ↗
hermes update --set-channel stable
This run only · nothing savedfrom Updating ↗
hermes update --channel main
Update with full HERMES_HOME backupfrom Updating ↗
hermes update --backup
Post-update validationfrom Updating ↗
hermes doctor && hermes --version && hermes gateway status
If terminal dropped mid-updatefrom Updating ↗
tail -f ~/.hermes/logs/update.log
Nix install updatefrom Nix & NixOS Setup ↗
nix flake update hermes-agent && sudo nixos-rebuild switch

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Next in the series · Episodes that build on this

E02
One-Line Install
E05
Hermes via Nix
E07
The Five Slash Commands