hermes - 💡(How to fix) Fix [Bug]: Dashboard fails after updating to 0.15.2: missing hermes_cli.dashboard_auth module [3 pull requests]

Bug Description

After updating Hermes from the dashboard, gateway and Discord now work, but the dashboard no longer starts.

The container still publishes 9119 correctly and logs show:

Starting hermes dashboard on 0.0.0.0:9119 (background) ModuleNotFoundError: No module named 'hermes_cli.dashboard_auth'

So this does not look like a Docker, Tailscale, or port binding issue. It looks like the updated package references hermes_cli.dashboard_auth, but that module is missing from the installed package.

FYO, My hermes lives in a docker container.

There may also be a Docker permission issue with the in-dashboard updater. In the official container, Hermes runs as UID 10000, but parts of /opt/hermes/.venv were not writable by that user. Pressing “Update Hermes” in dashboard failed with:

error: failed to remove file /opt/hermes/.venv/lib/python3.13/site-packages/hermes_agent-0.14.0.dist-info/INSTALLER: Permission denied (os error 13)

I worked around that with:

docker exec -u root hermes chown -R 10000:10000 /opt/hermes/.venv docker exec -u root hermes chmod -R u+rwX /opt/hermes/.venv

After that, the update to 0.15.2 completed, but the dashboard then failed with:

ModuleNotFoundError: No module named 'hermes_cli.dashboard_auth'

Steps to Reproduce

Update Hermes from version 0.14 (update button in dashboard).

Expected Behavior

Correct update from 0.14.0 to 0.15.2

Actual Behavior

Update failed.

Affected Component

Other, CLI (interactive chat)

Messaging Platform (if gateway-related)

No response

Debug Report

Report       https://paste.rs/F20N8
agent.log    https://paste.rs/5gA4I
gateway.log  https://paste.rs/P4iAS

Operating System

Ubuntu 26.04 LTS

Python Version

3.13.5

Hermes Version

No response

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

• I'd like to fix this myself and submit a PR