Official issues about Docker and containerized deployment. Sourced from the official GitHub repo; status derived from official labels; every entry links back to its source with a last-checked date.
#58135 Workaround P2 comp/agent [Bug]: `is_container()` false-positives on hosts running Docker containers (containerd markers in mountinfo), making `home_mode: auto` subprocess HOME non-deterministic — breaks browser auto-launch with "Chrome not found"
is_container() misidentifies a host as running inside a container when Docker containers using the containerd snapshotter are present, because it scans mountinfo for markers that also appear in overlay mounts on the host; the cached false result destabilizes home_mode: auto and can break browser auto-launch.
[Bug] v0.15.0 Docker image: stage2-hook.sh, main-wrapper.sh missing; container_boot module removed
The official v0.15.0 Docker image fails to start with exit code 127: two init scripts (stage2-hook.sh, main-wrapper.sh) present in source but missing from the built image, plus a reference to the hermes_cli.container_boot module that was removed in the v0.15.0 refactor. Issue is closed as fixed.
#25495 Fixed P1 comp/gateway [Bug]: Matrix / synapse broken in the official docker image
The Matrix/Synapse gateway in the official Docker image breaks after a certain build, with startup logs stalling at 'fixing ownership :1000'; the bot can still send messages but does not respond to channel prompts. Issue is closed as fixed.
[Bug]: Docker with HERMES_UID; permissions issue with Dashboard chat
Starting the Docker image with HERMES_UID/HERMES_GID and a shared volume causes permission-denied errors when using the Chat feature in the web Dashboard. Issue is closed as fixed.
Dashboard Chat tab fails with EACCES in Docker image — /opt/hermes/ui-tui is root-owned but dashboard runs as hermes
In the official Hermes Docker image, the dashboard's Chat tab fails on first connection because it runs as the unprivileged hermes user while /opt/hermes/ui-tui/ is root-owned, causing esbuild to fail writing the TUI bundle with EACCES.
[Feature]: Docker stable releases
The nousresearch/hermes-agent:latest Docker image updates every few hours, which is too frequent for some users; the issue requests a stable release tag/channel instead of manually pinning specific version tags.
[Feature]: Provide a lightweight Docker image without Playwright/Chromium
This issue reports that the official Docker image is about 2.4GB largely due to Playwright/Chromium dependencies, and requests a lightweight image tag that excludes browser automation for users who don't need it.
[Bug]: hermes command not found in external interactive shells after virtualenv migration (#8226)
This closed issue reports that after the virtualenv migration in PR #8226, the hermes command is not found in external interactive shells (e.g. docker exec) because the venv is not activated and its bin directory is not in PATH.
Docker image missing 'dashboard' command (web UI not available in latest image)
The nousresearch/hermes-agent:latest Docker Hub image lacked the dashboard subcommand even though it exists in the main branch source, making the web UI unusable in containerized setups like Coolify; the issue is now closed.