mirror of https://github.com/EKKOLearnAI/hermes-web-ui.git synced 2026-05-25 21:40:13 +00:00

Files

T

ekko b9b99042a0 refactor(docker): merge two-container setup into single container (#657 )

* refactor(docker): merge two-container setup into single container

The Web UI already manages the Hermes Agent gateway lifecycle internally
via GatewayManager (spawn hermes gateway run --replace), making the
separate hermes-agent container redundant. The Dockerfile is built on
the hermes-agent base image, so all CLI tooling is already included.

- Remove hermes-agent service and shared volume from docker-compose.yml
- Remove gateway port mapping (8642-8670) — internal-only now
- Update docs/docker.md, README.md, README_zh.md for single-container setup

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* docs: remove version tag from image references

Use ekkoye8888/hermes-web-ui instead of ekkoye8888/hermes-web-ui:latest
to avoid pinning a specific version in documentation.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-12 19:01:24 +08:00

3.1 KiB

Raw Blame History

Docker Compose Guide

This repository ships an environment-variable driven Docker Compose setup.

Quick Start

Pull pre-built image (Recommended)

WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d
docker compose logs -f hermes-webui

Open: http://localhost:6060

Build from source

docker compose up -d --build
docker compose logs -f hermes-webui

Services

This compose file runs a single service:

hermes-webui — Web UI dashboard with integrated Hermes Agent runtime (pre-built image or built from source)

The Web UI container is built on the nousresearch/hermes-agent base image and internally manages the Hermes Agent gateway lifecycle via GatewayManager.

Environment Variables

All key runtime settings are configured from compose variables.

Variable	Default	Description
`PORT`	`6060`	Web UI listen port
`BIND_HOST`	`0.0.0.0`	Optional Web UI bind host. Defaults to IPv4 for stable WSL/Windows access. Set `::` explicitly if you want IPv6 listening.
`HERMES_BIN`	`/opt/hermes/.venv/bin/hermes`	Path to Hermes CLI binary
`HERMES_AGENT_IMAGE`	`nousresearch/hermes-agent:latest`	Hermes Agent base image (used only during build)
`WEBUI_IMAGE`	`hermes-web-ui-local:latest`	Web UI image (set to `ekkoye8888/hermes-web-ui` to use pre-built)
`HERMES_DATA_DIR`	`./hermes_data`	Hermes runtime data directory
`AUTH_DISABLED`	`false`	Set to `true` to disable login authentication

Override variables directly from shell:

PORT=16060 \
AUTH_DISABLED=true \
docker compose up -d

Or create a .env file in the project root:

WEBUI_IMAGE=ekkoye8888/hermes-web-ui
PORT=6060
AUTH_DISABLED=false

Data Persistence

Path	Description
`${HERMES_DATA_DIR}` (`./hermes_data`)	Hermes runtime data (sessions, config, profiles)
`${HERMES_DATA_DIR}/hermes-web-ui`	Web UI data (auth token, etc.)

Hermes data persists in ./hermes_data, mapped to /home/agent/.hermes in the container.
Web UI data persists in ./hermes_data/hermes-web-ui/, mapped to /home/agent/.hermes-web-ui in the container.
When AUTH_DISABLED=false, the auth token is auto-generated on first run and printed to container logs.
Deleting the token file and restarting will generate a new one.

Port Mapping

Port	Description
`${PORT}` (6060)	Web UI dashboard

Hermes Agent gateway ports (8642-8670) are used internally within the container and are not exposed to the host.

Code Runtime Behavior

Hermes CLI binary comes from HERMES_BIN env (packages/server/src/services/hermes-cli.ts).
If HERMES_BIN is not provided, code falls back to hermes in PATH.
Profile switching dynamically resolves upstream URLs via GatewayManager.
The Web UI automatically starts and manages the Hermes Agent gateway process on startup.

Common Operations

Recreate:

docker compose up -d --force-recreate

View auth token:

docker compose logs hermes-webui | grep token
# or
cat ./hermes_data/hermes-web-ui/.token

Stop:

docker compose down

3.1 KiB Raw Blame History