# Update or roll back the Hermes version in xCloud Check the current version, apply an xCloud dashboard update during an agreed window, validate one core task and use documented pin or rollback controls only if needed. Canonical: https://xcloud.host/use-cases/playbooks/hermes-version-update/ Published: 2026-10-01 · Updated: 2026-10-01 · Technical review: 2026-10-01 Evidence: Source reviewed; no production deployment test claimed Editorial owner: xCloud editorial Intent: Update Hermes Agent version and verify a safe rollback path in xCloud For: administrator, team-owner ## Requirements and responsibilities - Assign a named team owner for this task and confirm that all needed service accounts, sources and data are within the approved scope. Never place credentials or private keys in agent prompts. Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) - Confirm the managed Hermes service is running and use only xCloud controls documented for this task; any upstream Hermes CLI, file or scheduled-job procedure needs an authorized operator and is not evidence of an xCloud panel feature. Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ## Illustrative situation Illustrative scenario: an administrator plans an agent version update and needs a functional baseline plus an available version rollback control. ## Choose the approach - Update only with a known functional baseline and a visible applicable rollback version; otherwise defer until a recovery option is established. Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ## Dashboard and application procedure ### 1. Establish a working baseline **Where:** Hermes dashboard → Status and Updates, then current terminal/Telegram path **Permissions:** Authorized Hermes administrator and task owner **Inputs:** Current version, harmless known request, expected response/delivery **Action:** Record the running version and complete a known harmless task before the change. Save the observed response/delivery and choose an agreed maintenance window. **Expected result:** The operator knows the current version and expected interruption. **Verify:** Confirm an owner is available to test the service afterward. **If it fails:** If current version or update state cannot be identified, defer the change. Capability: Operate documented Hermes controls in the xCloud dashboard Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ### 2. Confirm rollback control **Where:** Hermes dashboard → Updates **Permissions:** Authorized Hermes administrator **Inputs:** Current dashboard options **Action:** Inspect the available pin/rollback controls and note the documented recovery option before updating. **Expected result:** A current rollback option is visible or its absence is understood. **Verify:** Do not claim a prior version is restorable unless the dashboard offers it for this instance. **If it fails:** If there is no suitable rollback option, assess impact and obtain owner approval before update. Capability: Operate documented Hermes controls in the xCloud dashboard Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ### 3. Apply the update **Where:** Hermes dashboard → Updates **Permissions:** Authorized Hermes administrator **Inputs:** Approved window; confirmed current version **Action:** Open the target Hermes server’s Updates panel, inspect the current and offered versions, read the xCloud update notes shown for this instance, and select the visible update control once. Wait for the dashboard to report completion before starting the post-update task. **Expected result:** xCloud reports that the selected update completed and shows the resulting version. **Verify:** Recheck the running version and Status panel, then inspect Logs for update errors before testing the task. **If it fails:** If update fails or hangs, do not repeat blindly; inspect logs and use xCloud’s documented recovery path. Capability: Operate documented Hermes controls in the xCloud dashboard Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ### 4. Compare the same task after update **Where:** Hermes terminal or configured Telegram channel **Permissions:** Authorized Hermes user **Inputs:** Same harmless request and expected response/delivery from baseline **Action:** Repeat the exact supplied-text task and compare response and delivery to the recorded baseline. A version rollback only changes the selected Hermes version; it is not a data restore. **Expected result:** Agent response and delivery still meet the pre-update acceptance check. **Verify:** Compare against the saved baseline and inspect update logs. **If it fails:** If core workflow regresses, capture the error and decide whether the visible version rollback is appropriate; preserve separate data recovery planning. Capability: Use the authorized Hermes terminal, CLI or documented task interface Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ### 5. Roll back only if needed **Where:** Hermes dashboard → Updates → rollback/pin controls **Permissions:** Authorized Hermes administrator **Inputs:** Observed regression, current and target version **Action:** If the test shows a material regression, use the version rollback/pin action available in xCloud, then re-run the core workflow. **Expected result:** Dashboard confirms the chosen version state. **Verify:** Verify running version, status and core task after rollback. **If it fails:** If the desired version is unavailable, stop and contact xCloud support; do not improvise shell downgrade steps. Capability: Operate documented Hermes controls in the xCloud dashboard Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ## Maintenance - Record the running version after updates and periodically inspect whether the dashboard still offers the intended rollback version. Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ## Recovery decisions - If a regression appears, use the visible xCloud rollback/pin option only if available, then rerun the core task; otherwise contact xCloud support. Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) ## AI handoff Configure the needed provider, channel, credentials and permissions separately. This guide does not imply xCloud has preconfigured upstream tools or scheduled jobs. ### Supported scope - **Operate documented Hermes controls in the xCloud dashboard** (dashboard; manual): Manual xCloud interface. Use only deployment, Providers, Channels, Workspace and Updates controls documented by xCloud; do not infer extra dashboard capabilities. Checkpoint: Confirm the intended Hermes server and current visible control before saving a change. Sources: [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/); [xCloud Telegram setup for Hermes](https://xcloud.host/docs/create-a-telegram-bot-and-connect-it-with-hermes/); [xCloud Hermes Workspace setup guide](https://xcloud.host/docs/how-to-set-up-hermes-workspace-with-xcloud/) - **Use the authorized Hermes terminal, CLI or documented task interface** (app; manual): Upstream Hermes CLI/configuration workflow; requires an authorized operator and does not prove xCloud preconfigured the feature or exposed it in its panel. Checkpoint: Check the installed Hermes version and current upstream instructions; review scope and permissions before running a task. Sources: [Hermes quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart); [Hermes cron feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron); [Hermes memory feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory); [Hermes skills feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills); [Hermes agent email address tutorial](https://hermes-agent.nousresearch.com/docs/guides/agent-email-address); [Hermes GitHub PR review agent tutorial](https://hermes-agent.nousresearch.com/docs/guides/github-pr-review-agent); [Hermes delegation feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/delegation) ### Copyable agent brief ```text After an authorized xCloud version update, run the same harmless baseline task and report version/status and any regression. Do not update or roll back without operator action. ``` ### Manual checkpoints - An authorized administrator uses the documented Hermes Updates panel. A version rollback is separate from restoring agent data. - Review the task-specific acceptance check and inspect actual output, configuration or run history before relying on it. ## Feature coverage - **Documented Hermes task path** (covered): Steps identify whether an action uses documented xCloud controls, upstream operator configuration or human review. Steps: step-1, step-2, step-3, step-4, step-5 - **Task-specific acceptance check** (covered): The final step validates this guide’s stated result. Steps: step-5 ## Sources - [xCloud Hermes Agent deployment guide](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) — reviewed 2026-10-01 - [xCloud Telegram setup for Hermes](https://xcloud.host/docs/create-a-telegram-bot-and-connect-it-with-hermes/) — reviewed 2026-10-01 - [xCloud Hermes Workspace setup guide](https://xcloud.host/docs/how-to-set-up-hermes-workspace-with-xcloud/) — reviewed 2026-10-01 - [Hermes quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) — reviewed 2026-10-01 - [Hermes cron feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) — reviewed 2026-10-01 - [Hermes memory feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) — reviewed 2026-10-01 - [Hermes skills feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) — reviewed 2026-10-01 - [Hermes agent email address tutorial](https://hermes-agent.nousresearch.com/docs/guides/agent-email-address) — reviewed 2026-10-01 - [Hermes GitHub PR review agent tutorial](https://hermes-agent.nousresearch.com/docs/guides/github-pr-review-agent) — reviewed 2026-10-01 - [Hermes delegation feature guide](https://hermes-agent.nousresearch.com/docs/user-guide/features/delegation) — reviewed 2026-10-01 ## Continue [Review xCloud Hermes deployment options](https://xcloud.host/docs/how-to-deploy-hermes-agent-with-xcloud/) - [Change the Hermes model provider from xCloud](https://xcloud.host/use-cases/playbooks/hermes-provider-change/)