services.yml

---
# nocheck: playwright-service-flag
hermes:
  mcp_consumer: true
  modes:
    compose:
      enabled: true
    swarm:
      enabled: true
  # nocheck: single-replica the agent keeps its kanban board in one embedded SQLite file on the shared volume, and its runtime turns WAL off on a network filesystem because the shared-memory index WAL coordinates writers through is per-host and not coherent between nodes
  replicas: 1
  bond: 1
  enabled: true
  shared: true
  backup:
    stop_required: false
  image: nousresearch/hermes-agent
  version: "v2026.9.24"
  name: hermes
  min_context: 64000
  min_storage: 1146MB
  cpus: "2.0"
  mem_reservation: 2g
  mem_limit: 4g
  pids_limit: 2048
  ports:
    local:
      http: 8092
      sso: 16512
      agent: 8501
      sso_onion: 16530
    internal:
      http: 8642
      agent: 9119
    onion:
      # nocheck: onion-flag  this port carries the web UI, which answers on the root of the proxy vhost that the node onion already forwards; a direct forward would bypass the proxy, its sign-in gate and its CSP
      agent: false
  lifecycle: beta
  proxy:
    service_key: hermes

# nocheck: dynamic-flag - the web UI is a role-local off-switch; no provider role exists whose group membership could decide it
webui:
  enabled: false

# nocheck: playwright-service-flag, dynamic-flag
kata:
  bond: 1
  enabled: true
  shared: true

sso:
  bond: 1
  enabled: "{{ 'web-app-keycloak' in group_names }}"
  shared: "{{ 'web-app-keycloak' in group_names }}"
  flavor: oauth2
  oauth2:
    origin:
      host: hermes
      port: "{{ lookup('config', 'web-app-hermes', 'services.hermes.ports.internal.' ~ ('agent' if lookup('config', 'web-app-hermes', 'services.webui.enabled') |
        bool else 'http')) }}"
    acl:
      whitelist:
        - /v1/
        - /health
    allowed_groups:
      - "{{ lookup('rbac_group_path', application_id='web-app-hermes', role='administrator') }}"
      - "{{ lookup('rbac_group_path', application_id='web-app-hermes', role='mcp') }}"

# nocheck: logout, dynamic-flag, playwright-service-flag
logout:
  enabled: false
  shared: false

# nocheck: playwright-service-flag, dynamic-flag - the gateway is a single shared instance, never deployed per consumer
litellm:
  bond: 1
  enabled: "{{ LITELLM_USABLE }}"
  shared: true

dashboard:
  bond: 1
  enabled: "{{ 'web-app-dashboard' in group_names }}"
  shared: "{{ 'web-app-dashboard' in group_names }}"
matomo:
  bond: 1
  enabled: "{{ 'web-app-matomo' in group_names }}"
  shared: "{{ 'web-app-matomo' in group_names }}"
design:
  bond: 1
  enabled: "{{ 'web-svc-design' in group_names }}"
  shared: "{{ 'web-svc-design' in group_names }}"
  title: "{{ SOFTWARE_NAME }} Agent"
  slots:
    brand:
      width: 320
      height: 64
prometheus:
  bond: 1
  enabled: "{{ 'web-app-prometheus' in group_names }}"
  shared: "{{ 'web-app-prometheus' in group_names }}"
  ready_path: health

# nocheck: playwright-service-flag
# nocheck: variants-coverage — sso-variant-tor requires the onion on in every variant, so the false polarity has no variant left to live in
tor:
  bond: 0.5
  enabled: "{{ 'svc-net-tor' in group_names }}"
  shared: true # nocheck: dynamic-flag

# nocheck: playwright-service-flag, dynamic-flag
container_backup: # nocheck: bond-baseline
  bond: 1
  enabled: "{{ 'svc-bkp-volume-2-local' in group_names }}"
  shared: true

docs:
  bond: 0.5
  enabled: "{{ 'web-app-docs' in group_names }}"
  shared: "{{ 'web-app-docs' in group_names }}"