hermes-web-ui Docker & Self-Hosted Deployment

GitHub

Web dashboard for Hermes Agent — multi-platform AI chat, session management, scheduled jobs, usage analytics

9,944 stars TypeScript TypeScript 1 file · ~10,914 tokens #agent#ai-agent#chat-ui#dashboard#hermes#hermes-agent#hermes-web-ui#llm
RAW Compose
1. Pull Image (DOCKERHUB) docker pull library/${WEBUI_IMAGE
2. Docker Run (1-Click Launch) docker run -d --name hermes-web-ui -p 8651:8651 --restart always ${WEBUI_IMAGE:-hermes-web-ui-local:latest}
3. Podman Run podman run -d --name hermes-web-ui -p 8651:8651 --restart always ${WEBUI_IMAGE:-hermes-web-ui-local:latest}
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://docker.io/library/${WEBUI_IMAGE:-hermes-web-ui-local
5. ORAS Pull (OCI Artifact) oras pull ${WEBUI_IMAGE:-hermes-web-ui-local:latest}
6. Compose Deployment docker compose up -d
docker-compose.yml
Download .yml 
services:
  hermes-webui:
    build:
      context: .
      dockerfile: Dockerfile
    image: ${WEBUI_IMAGE:-hermes-web-ui-local:latest}
    container_name: ${WEBUI_CONTAINER_NAME:-hermes-webui}
    ports:
      - "${PORT:-6060}:${PORT:-6060}"
      - "${PREVIEW_FRONTEND_PORT:-8651}:8651"
      - "${XAI_OAUTH_PORT:-56121}:56121"
      - "${STUDIO_P2P_UDP_PORT_RANGE:-50000-50127}:${STUDIO_P2P_UDP_PORT_RANGE:-50000-50127}/udp"
    volumes:
      - ${HERMES_DATA_DIR:-./hermes_data}:/home/agent/.hermes
      - ${HERMES_DATA_DIR:-./hermes_data}/hermes-web-ui:/home/agent/.hermes-web-ui
    environment:
      - PORT=${PORT:-6060}
      - HERMES_HOME=/home/agent/.hermes
      - HERMES_BIN=/opt/hermes/.venv/bin/hermes
      - HERMES_WEB_UI_MANAGED_GATEWAY=1
      - HERMES_WEB_UI_AUTH_JWT_EXPIRES_IN=${HERMES_WEB_UI_AUTH_JWT_EXPIRES_IN:-30d}
      - HERMES_WEB_UI_XAI_CALLBACK_BIND_HOST=0.0.0.0
      - HERMES_PATCH_SCRIPT=${HERMES_PATCH_SCRIPT:-}
      - HERMES_LAN_ADVERTISE_URL=${HERMES_LAN_ADVERTISE_URL:-}
      - HERMES_APP_ENTITLEMENT_REQUIRED=${HERMES_APP_ENTITLEMENT_REQUIRED:-true}
      - HERMES_APP_ENTITLEMENT_PUBLIC_KEY=${HERMES_APP_ENTITLEMENT_PUBLIC_KEY:-}
      - STUDIO_P2P_UDP_PORT_RANGE=${STUDIO_P2P_UDP_PORT_RANGE:-50000-50127}
      - STUDIO_P2P_INTERFACE=${STUDIO_P2P_INTERFACE:-}
      - STUDIO_P2P_ADVERTISE_ADDRESSES=${STUDIO_P2P_ADVERTISE_ADDRESSES:-}
      - NPM_CONFIG_PREFIX=/home/agent/.hermes-web-ui/coding-agent/npm
      - PATH=/home/agent/.hermes-web-ui/coding-agent/npm/bin:/opt/hermes/.venv/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
      - HERMES_ALLOW_ROOT_GATEWAY=1
    restart: unless-stopped
    stdin_open: true
    tty: true