Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Bug] v0.15.0 Docker image: stage2-hook.sh, main-wrapper.sh missing; container_boot module removed

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

Error Log

Root Cause

1. Missing init scripts — Dockerfile line 229-232 creates 01-hermes-setup which execs /opt/hermes/docker/stage2-hook.sh. ENTRYPOINT (line 290) references /opt/hermes/docker/main-wrapper.sh. Both files exist in the source tree at docker/stage2-hook.sh and docker/main-wrapper.sh but are not present at those paths in the built image. The COPY --chown=hermes:hermes . . (line 159) should include them — likely a build-context or multi-stage issue.

2. Deleted module reference — docker/cont-init.d/02-reconcile-profiles runs:

exec s6-setuidgid hermes /opt/hermes/.venv/bin/python -m hermes_cli.container_boot

The hermes_cli.container_boot module was removed during the v0.15.0 refactor but this init script reference was not updated.

Code Example

/etc/cont-init.d/01-hermes-setup: 2: exec: /opt/hermes/docker/stage2-hook.sh: not found
/opt/hermes/.venv/bin/python: No module named hermes_cli.container_boot
/run/s6/basedir/scripts/rc.init: 91: /opt/hermes/docker/main-wrapper.sh: not found

---

exec s6-setuidgid hermes /opt/hermes/.venv/bin/python -m hermes_cli.container_boot
RAW_BUFFERClick to expand / collapse

Bug Description

The nousresearch/hermes-agent:latest Docker image (v0.15.0 / v2026.5.28) crashes on startup with three init failures. The container exits with code 127.

Error Log

/etc/cont-init.d/01-hermes-setup: 2: exec: /opt/hermes/docker/stage2-hook.sh: not found
/opt/hermes/.venv/bin/python: No module named hermes_cli.container_boot
/run/s6/basedir/scripts/rc.init: 91: /opt/hermes/docker/main-wrapper.sh: not found

Root Cause

1. Missing init scripts — Dockerfile line 229-232 creates 01-hermes-setup which execs /opt/hermes/docker/stage2-hook.sh. ENTRYPOINT (line 290) references /opt/hermes/docker/main-wrapper.sh. Both files exist in the source tree at docker/stage2-hook.sh and docker/main-wrapper.sh but are not present at those paths in the built image. The COPY --chown=hermes:hermes . . (line 159) should include them — likely a build-context or multi-stage issue.

2. Deleted module reference — docker/cont-init.d/02-reconcile-profiles runs:

exec s6-setuidgid hermes /opt/hermes/.venv/bin/python -m hermes_cli.container_boot

The hermes_cli.container_boot module was removed during the v0.15.0 refactor but this init script reference was not updated.

Steps to Reproduce

  1. docker run --rm nousresearch/hermes-agent:latest
  2. Container immediately exits with code 127
  3. Check logs

Image Info

  • nousresearch/hermes-agent:latest (v0.15.0, tag v2026.5.28, commit 0c859a1)

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING