Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Setup]: docker hermes 0.11 fails to start [2 comments, 2 participants]

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…
GitHub stats
NousResearch/hermes-agent#15001•Fetched 2026-04-25 06:25:20
View on GitHub
Comments
2
Participants
2
Timeline
7
Reactions
0
Author
UmbraAtroxUmbraAtrox
Participants
alt-glitchalt-glitchUmbraAtroxUmbraAtrox
Timeline (top)
labeled ×4commented ×2closed ×1

Error Message

Full Error Output

Code Example

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    environment:
      HERMES_UID: 1000
      HERMES_GID: 987
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    volumes:
      - /home/myuser/.hermes:/opt/data

---



---

docker container logs with existing ~/.hermes:/opt/data

mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied


logs with new user (1000:1000) owned ~/.hermes2:/opt/data

hermes  | mkdir: cannot create directory '/opt/data/cron': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/sessions': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/logs': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/hooks': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/memories': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/skills': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/skins': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/plans': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/workspace': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/home': Permission denied
hermes exited with code 1 (restarting)
RAW_BUFFERClick to expand / collapse

What's Going Wrong?

updated docker hermes 0.10 -> 0.11, container fails to start

Steps Taken

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    environment:
      HERMES_UID: 1000
      HERMES_GID: 987
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    volumes:
      - /home/myuser/.hermes:/opt/data

Installation Method

Docker

Operating System

debian 13

Python Version

No response

Hermes Version

No response

Debug Report

Full Error Output

docker container logs with existing ~/.hermes:/opt/data

mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied
mkdir: cannot create directory '/opt/data': Permission denied


logs with new user (1000:1000) owned ~/.hermes2:/opt/data

hermes  | mkdir: cannot create directory '/opt/data/cron': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/sessions': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/logs': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/hooks': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/memories': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/skills': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/skins': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/plans': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/workspace': Permission denied
hermes  | mkdir: cannot create directory '/opt/data/home': Permission denied
hermes exited with code 1 (restarting)

What I've Already Tried

No response

extent analysis

TL;DR

The issue is likely due to incorrect permissions on the /opt/data directory, preventing the Hermes container from creating necessary subdirectories.

Guidance

  • Verify the ownership and permissions of the /opt/data directory in the container by checking the HERMES_UID and HERMES_GID environment variables.
  • Ensure the user with the specified HERMES_UID (1000) has write permissions on the /opt/data directory.
  • Check the permissions of the host directory /home/myuser/.hermes to ensure it is compatible with the container's expected permissions.
  • Consider running the container with a different user or group to match the ownership of the host directory.

Example

No code snippet is provided as the issue seems to be related to container configuration and permissions.

Notes

The issue may be specific to the Hermes version 0.11, and checking the documentation for any changes in permissions or directory structure may be helpful.

Recommendation

Apply workaround by adjusting the permissions of the /opt/data directory or the user running the container to ensure compatibility with the host directory permissions.

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…
#installation#autograd error#model save/load#optimization#mixed precision

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix [Setup]: docker hermes 0.11 fails to start [2 comments, 2 participants]