mirror of https://github.com/EKKOLearnAI/hermes-web-ui.git synced 2026-05-26 05:50:18 +00:00

Files

T

ekko 8ad0723b00 docs: update Docker deployment guide and compose config

- Update docker-compose.yml: use hermes-agent internal hostname for UPSTREAM,
  expose ports 8642-8670, add server data volume mapping
- Rewrite docs/docker.md with pre-built image usage, env var table,
  data persistence (token location), port mapping, and common operations
- Update README.md and README_zh.md Docker section with pre-built image
  instructions and token location

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

2026-04-20 19:55:31 +08:00

3.0 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:latest docker compose up -d hermes-agent hermes-webui
docker compose logs -f hermes-webui

Open: http://localhost:6060

Build from source

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

Services

This compose file runs two services:

hermes-agent — Hermes Agent runtime (image: nousresearch/hermes-agent)
hermes-webui — Web UI dashboard (pre-built image or built from source)

Environment Variables

All key runtime settings are configured from compose variables.

Variable	Default	Description
`PORT`	`6060`	Web UI listen port
`UPSTREAM`	`http://hermes-agent:8642`	Hermes gateway URL (container internal)
`HERMES_BIN`	`/opt/hermes/.venv/bin/hermes`	Path to Hermes CLI binary
`HERMES_AGENT_IMAGE`	`nousresearch/hermes-agent:latest`	Hermes Agent base image
`WEBUI_IMAGE`	`hermes-web-ui-local:latest`	Web UI image (set to `ekkoye8888/hermes-web-ui:latest` 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 hermes-agent hermes-webui

Or create a .env file in the project root:

WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest
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-data`	Web UI data (auth token)

Hermes data persists in ./hermes_data, mapped to /home/agent/.hermes in the container.
Web UI auth token persists in ./hermes_data/hermes-web-ui-data/.token.
When AUTH_DISABLED=false, the 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	Service	Description
`${PORT}` (6060)	hermes-webui	Web UI dashboard
8642-8670	hermes-agent	Hermes Agent gateway ports (for multi-profile)

Code Runtime Behavior

Server upstream comes from UPSTREAM env (packages/server/src/config.ts).
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 UPSTREAM env only sets the default profile gateway.

Common Operations

Recreate webui:

docker compose up -d --no-deps --force-recreate hermes-webui

View auth token:

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

Stop:

docker compose down

3.0 KiB Raw Blame History