mirror of
https://github.com/EKKOLearnAI/hermes-web-ui.git
synced 2026-05-25 05:20:15 +00:00
P2K0
f0d1d2e16c
- add docker-compose setup with hermes-agent + hermes-webui - make runtime config env-driven (compose vars + HERMES_BIN) - improve gateway startup/restart resilience in docker - make base image configurable via BASE_IMAGE/HERMES_AGENT_IMAGE Closes https://github.com/EKKOLearnAI/hermes-web-ui/issues/14
63 lines
1.5 KiB
Markdown
63 lines
1.5 KiB
Markdown
# Docker Compose Guide
|
|
|
|
This repository ships an environment-variable driven Docker Compose setup.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
docker compose up -d --build hermes-agent hermes-webui
|
|
docker compose logs -f hermes-webui
|
|
```
|
|
|
|
Open: `http://localhost:6060`
|
|
|
|
## Environment Variables
|
|
|
|
All key runtime settings are configured from compose variables.
|
|
This compose file runs two services together:
|
|
|
|
- `hermes-agent` (image: `nousresearch/hermes-agent`)
|
|
- `hermes-webui` (built from this repository)
|
|
|
|
Compose mapping highlights:
|
|
|
|
- Host/browser port: `${PORT}:${PORT}`
|
|
- Server `PORT` is set from `${PORT}`
|
|
- Upstream is set from `${UPSTREAM}`
|
|
- Hermes CLI binary is set from `${HERMES_BIN}`
|
|
- Hermes base image is set from `${HERMES_AGENT_IMAGE}` (used by both `hermes-agent` and webui build base)
|
|
|
|
Override variables directly from shell when running compose:
|
|
|
|
```bash
|
|
PORT=16060 \
|
|
UPSTREAM=http://127.0.0.1:8642 \
|
|
HERMES_BIN=/opt/hermes/.venv/bin/hermes \
|
|
docker compose up -d --build hermes-agent hermes-webui
|
|
```
|
|
|
|
## Data Persistence
|
|
|
|
- Hermes runtime data persists in `${HERMES_DATA_DIR}`.
|
|
- Default path is `./hermes_data`.
|
|
|
|
## 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`.
|
|
|
|
## Common Operations
|
|
|
|
Recreate webui:
|
|
|
|
```bash
|
|
docker compose up -d --no-deps --force-recreate hermes-webui
|
|
```
|
|
|
|
Stop:
|
|
|
|
```bash
|
|
docker compose down
|
|
```
|