The /opt/data volume is the single source of truth for all Hermes state.

Target

/opt/data

Default

/mnt/cache/appdata/hermes-agent

Value

/mnt/cache/appdata/hermes-agent

Port for the dashboard HTTP server

Target

9119

Default

9119

Value

9119

Set to 1 (or true / yes) to launch the dashboard alongside the main command

Default

1

Value

1

Bind address for the dashboard HTTP server

Default

0.0.0.0

Value

0.0.0.0

Port for the dashboard HTTP server

Default

9119

Value

9119

Enable the API server

Default

false

Value

false

Bearer token for auth

Telegram bot token (from @BotFather)

Comma-separated user IDs allowed to use the bot (applies to DMs, groups, and forums)

Comma-separated sender user IDs authorized in groups/forums only (does NOT grant DM access). Chat-ID-shaped values (starting with -) are still honored as chat IDs for backward compat with pre-#17686 configs, with a deprecation warning.

Comma-separated group/forum chat IDs; any member is authorized

Set HERMES_UID/HERMES_GID to match your host user, or ensure the data directory is writable.

Default

100

Value

100

Set HERMES_UID/HERMES_GID to match your host user, or ensure the data directory is writable.

Default

99

Value

99