From ebd0291ef243162be1a999a1345bf259cbc78203 Mon Sep 17 00:00:00 2001 From: Teknium Date: Sun, 22 Mar 2026 05:03:17 -0700 Subject: [PATCH] docs(honcho): add self-hosted / Docker configuration section Document HONCHO_BASE_URL for users running a local Honcho instance. Both hermes config and ~/.honcho/config.json paths are covered. Closes #2318 --- website/docs/user-guide/features/honcho.md | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/website/docs/user-guide/features/honcho.md b/website/docs/user-guide/features/honcho.md index f9748070e..4adb015c2 100644 --- a/website/docs/user-guide/features/honcho.md +++ b/website/docs/user-guide/features/honcho.md @@ -25,6 +25,33 @@ Hermes has two memory systems that can work together or be configured separately Set `memoryMode` to `honcho` to use Honcho exclusively. See [Memory Modes](#memory-modes) for per-peer configuration. +## Self-hosted / Docker + +Hermes supports a local Honcho instance (e.g. via Docker) in addition to the hosted API. Point it at your instance using `HONCHO_BASE_URL` — no API key required. + +**Via `hermes config`:** + +```bash +hermes config set HONCHO_BASE_URL http://localhost:8000 +``` + +**Via `~/.honcho/config.json`:** + +```json +{ + "hosts": { + "hermes": { + "base_url": "http://localhost:8000", + "enabled": true + } + } +} +``` + +Hermes auto-enables Honcho when either `apiKey` or `base_url` is present, so no further configuration is needed for a local instance. + +To run Honcho locally, refer to the [Honcho self-hosting docs](https://docs.honcho.dev). + ## Setup ### Interactive Setup