hermes - 💡(How to fix) Fix [Bug]: user expience for ur docker is so bad. [1 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#14448Fetched 2026-04-24 06:17:13
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Participants
Timeline (top)
labeled ×3subscribed ×1

Error Message

Additional Logs / Traceback (optional)

Root Cause

Root Cause Analysis (optional)

Code Example

not up yet

---
RAW_BUFFERClick to expand / collapse

Bug Description

it says: 10000 user(but the hermes-webui is 1000) mkdir /root failure(even previledged).I don't know why u mkdir /root?in production it is forbidden and unecessary. and the mount dir host:docker is unclear and frustrating.

Steps to Reproduce

Three-container Docker Compose: Hermes Agent + Dashboard + WebUI

This extends the two-container setup with the Hermes Dashboard for

monitoring agent activity, sessions, and resource usage.

Usage:

docker compose -f docker-compose.three-container.yml up -d

Services:

hermes-agent — gateway API on port 8642 (CLI, Telegram, cron, tools)

hermes-dashboard — monitoring dashboard on port 9119

hermes-webui — browser chat interface on port 8787

All three share the same hermes-home volume so config, sessions,

skills, and memory are consistent across all surfaces.

services: hermes-agent: image: nousresearch/hermes-agent:latest container_name: hermes-agent command: gateway run #privileged: true user: root ports: - "127.0.0.1:8642:8642" volumes: # Persist config, state, sessions, skills, memory across restarts - /mnt/data/hermes-allinone:/root/.hermes # Expose agent source so the WebUI can install dependencies from it #- /mnt/data/hermes-allinone/hermes-agent-src:/opt/hermes environment: - HERMES_HOME=/root/.hermes restart: unless-stopped deploy: resources: limits: memory: 4G cpus: "2.0" networks: - hermes-net

hermes-dashboard: image: nousresearch/hermes-agent:latest container_name: hermes-dashboard command: dashboard --host 0.0.0.0 --insecure ports: - "127.0.0.1:9119:9119" volumes: - /mnt/data/hermes-allinone:/root/.hermes environment: - HERMES_HOME=/root/.hermes # Dashboard connects to the gateway for health/session data - GATEWAY_HEALTH_URL=http://hermes-agent:8642 depends_on: - hermes-agent restart: unless-stopped deploy: resources: limits: memory: 512M cpus: "0.5" networks: - hermes-net

hermes-webui: image: ghcr.io/nesquena/hermes-webui:latest container_name: hermes-webui depends_on: - hermes-agent ports: # Expose on localhost only. Remove 127.0.0.1: to expose on all interfaces # (set HERMES_WEBUI_PASSWORD if doing so). #- "127.0.0.1:8787:8787" - "8787:8787" volumes: # Same hermes home as the agent — shares config, sessions, state - /mnt/data/hermes-allinone:/home/hermeswebui/.hermes # Agent source mounted where docker_init.bash expects it. # At startup the init script runs: # uv pip install /home/hermeswebui/.hermes/hermes-agent # which installs the agent and all its Python dependencies. - /mnt/data/hermes-allinone/hermes-agent-src:/home/hermeswebui/.hermes/hermes-agent # Workspace directory — browse and edit files from the WebUI. # Use HERMES_WORKSPACE env var, default to /mnt/data/hermes-allinone/workspace - ${HERMES_WORKSPACE:-/mnt/data/hermes-allinone/workspace}:/workspace environment: - HERMES_WEBUI_HOST=0.0.0.0 - HERMES_WEBUI_PORT=8787 - HERMES_WEBUI_STATE_DIR=/home/hermeswebui/.hermes/webui # Match your host user's UID/GID for correct file permissions. # Run id -u and id -g to find your values. # On macOS, UIDs start at 501 (not 1000) — set these in a .env file: # echo "UID=$(id -u)" >> .env && echo "GID=$(id -g)" >> .env - WANTED_UID=${UID:-10000} - WANTED_GID=${GID:-10000} # Optional: set a password for remote access # - HERMES_WEBUI_PASSWORD=your-secret-password restart: unless-stopped networks: - hermes-net

networks: hermes-net: driver: bridge

Expected Behavior

update ur docker image ,check ur docs and rewrite.

Actual Behavior

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

Dropping root privileges

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

Dropping root privileges

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

mkdir: cannot create directory '/root': Permission denied

Affected Component

Other

Messaging Platform (if gateway-related)

No response

Debug Report

not up yet

Operating System

root@xbase:/mnt/data# uname -r 6.6.127

Python Version

No response

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

extent analysis

TL;DR

The issue is likely caused by the hermes-webui container trying to create a directory at /root which is not allowed due to permission issues, and can be fixed by adjusting the volume mounts and user permissions.

Guidance

  • Check the hermes-webui container's volume mounts and ensure that the /home/hermeswebui/.hermes directory is writable by the container's user.
  • Adjust the WANTED_UID and WANTED_GID environment variables in the hermes-webui service to match the host user's UID and GID.
  • Verify that the hermes-webui container is not trying to write to the host's /root directory, but rather to the mounted volume at /home/hermeswebui/.hermes.
  • Consider setting the user parameter in the hermes-webui service to a non-root user to avoid permission issues.

Example

No code example is provided as the issue is related to container configuration and permissions.

Notes

The issue seems to be related to the hermes-webui container's configuration and permissions. Adjusting the volume mounts and user permissions should resolve the issue. However, without more information about the host system and the desired behavior, it's difficult to provide a more specific solution.

Recommendation

Apply a workaround by adjusting the hermes-webui container's configuration to use a non-root user and ensure that the volume mounts are correct. This should resolve the permission issues and allow the container to run without errors.

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