Hermes Agent en Docker: setup, Compose y un VPS de verdad
Setup de Hermes Agent en Docker con la imagen oficial, del docker run al primer chat, y después qué traen la imagen y el Compose, HERMES_HOME, perfiles, auth del dashboard, upgrade y las trampas de Swarm en un VPS.
Para correr Hermes Agent en Docker, usa la imagen oficial nousresearch/hermes-agent. Monta un directorio del host en /opt/data (ese es HERMES_HOME: config, API keys, memoria, skills, state.db), corre el wizard setup una vez y después levanta el contenedor con gateway run. Con HERMES_DASHBOARD=1, el dashboard web sube en el puerto 9119 en el mismo contenedor.
Corro Hermes headless en un Docker Swarm en un VPS. El quick start de abajo es el camino oficial; todo lo que viene después es lo que el camino oficial no cuenta, incluidas seis trampas que me costaron tiempo de verdad.
Quick start: del docker run al primer chat
Estos comandos vienen de la documentación oficial de Docker de Hermes (revisada el 13/10/2026), en el orden en que los corres. Córrelos por SSH, no desde la consola web del proveedor: la documentación avisa que esas consolas cambian : y @, lo que rompe en silencio el -v ~/.hermes:/opt/data y las API keys que pegas.
Hermes Agent en Docker, primera ejecución
1. Crea el directorio de datos en el host
mkdir -p ~/.hermes2. Corre el wizard de setup una vez (guarda las keys en ~/.hermes/.env)
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup3. Levanta el gateway en segundo plano
docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data -p 8642:8642 nousresearch/hermes-agent gateway run4. Revisa que haya levantado
docker logs --tail 50 hermes5. Abre un chat contra el mismo directorio de datos
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent
El wizard pide una key de proveedor de modelo y, mejor si es así, una plataforma de chat (Telegram, Discord, Slack) para que el gateway escuche. El puerto 8642 es la API compatible con OpenAI y el endpoint de health del gateway: opcional si solo hablas con Hermes desde una app de chat, obligatorio si el dashboard o un cliente externo necesita alcanzarlo. Dentro de la imagen oficial el gateway corre supervisado por s6, así que un crash lo reinicia en un par de segundos sin tirar el contenedor.
Tags: latest y stable apuntan al build que pasó el gate de release estable. El 13/10/2026 era v0.21.7, lanzada el 12 de octubre (Docker Hub, notas de la release). Hay tags por versión (v0.21.6), pero v0.21.7 solo salió como stable, latest y su tag de release candidate, así que el pin confiable es un digest, no un string de versión. main es el build de desarrollo. No lo corras en una máquina de la que dependes.
Compose: un servicio, o los dos del repo
La documentación de Nous y el repo no coinciden en la forma, y los dos tienen razón. La documentación corre un solo contenedor: el gateway y el dashboard como un segundo servicio de s6, encendido con HERMES_DASHBOARD=1:
services:
hermes:
image: nousresearch/hermes-agent:latest
container_name: hermes
restart: unless-stopped
command: gateway run
ports:
- "8642:8642" # gateway API
- "9119:9119" # dashboard (only reached when HERMES_DASHBOARD=1)
volumes:
- ~/.hermes:/opt/data
environment:
- HERMES_DASHBOARD=1
deploy:
resources:
limits:
memory: 4G
cpus: "2.0"
Levántalo con docker compose up -d. Usa este salvo que tengas una razón para no hacerlo. El docker-compose.yml del propio repo (leído más abajo) corre el dashboard en un contenedor aparte, algo que la documentación solo soporta cuando comparte el namespace de PID y de red del host, como hace el archivo del repo con network_mode: host. El dashboard detecta si el gateway está vivo mirando su proceso, así que un contenedor de dashboard aislado en una red bridge no lo ve.
Un detalle antes de exponer el 9119: dentro del contenedor el dashboard se bindea a 0.0.0.0 por defecto, y un bind fuera de loopback sin proveedor de auth se niega a arrancar. Es a propósito. La sección de auth más abajo muestra qué configurar.
Hermes Desktop, la app nativa, se conecta a este mismo backend del dashboard desde su opción Remote Gateway, en el puerto 9119. Una conexión cubre todos los perfiles del contenedor con el selector de perfil de la app.
Qué trae realmente la imagen Docker de Hermes Agent
El Dockerfile publicado se construye desde debian:13.4, fijado por su digest sha256 en vez de un tag, porque el resto del build (un uv fijado, un Chromium fijado) ya viene de un lock verificado por sha, y una imagen base flotante se desalinearía debajo de ellos. La primera etapa del build compila SQLite 3.53.4 desde el código fuente y usa ese .so en vez del 3.46.1 que trae Debian 13, que todavía carga el bug de corrupción de WAL-reset upstream. Si alguna vez viste una instalación de Hermes quejarse de un state.db corrupto sobre un paquete de SQLite de la distro, esta es la razón por la que la imagen del contenedor lo evita por completo.
El PID 1 dentro del contenedor es s6-overlay, no tini. Tini se encargaba de recoger los procesos zombie que se acumulan cuando Hermes lanza subprocesos stdio de MCP, git o bun como PID 1; s6-overlay hace la misma recolección sin bloquear y además supervisa el proceso principal de Hermes, el dashboard y los gateways por perfil como servicios con nombre bajo /etc/s6-overlay/s6-rc.d/. Todavía existe un shim de compatibilidad liviano en /usr/bin/tini para templates de orquestación que tienen fijo el entrypoint viejo, pero solo quita los flags de CLI de tini y vuelve a ejecutar /init.
El ENTRYPOINT en sí ya no es /init. Es un dispatcher chico, /opt/hermes/docker/entrypoint-dispatch.sh. Cuando el contenedor es dueño del PID 1, el caso normal de Docker y Podman, hace exec de /init y tienes todo el árbol de s6. Cuando la plataforma pone su propio init encima (Fly.io Machines, docker run --init, algunos setups de Nomad y Kubernetes), /init abortaría con can only run as pid 1, así que el dispatcher corre el hook de setup y tu comando directo. El comando funciona. El dashboard y los gateways por perfil no corren en ese camino, porque nada los supervisa. Si un Compose sobrescribe entrypoint: para llamar a hermes directo, también pierdes el recolector de zombies; la documentación reporta un deploy con 284 procesos zombie en menos de tres horas. Deja el entrypoint por defecto. (El comentario del docker-compose.yml del repo todavía nombra el entrypoint viejo ["/init", "/opt/hermes/docker/main-wrapper.sh"]; la fuente de verdad es el Dockerfile.)
El contenedor corre como un usuario hermes sin privilegios de root, UID 10000 por defecto, que se puede sobrescribir al arrancar con HERMES_UID y HERMES_GID para que los archivos que escribe sigan siendo del usuario del host que realmente seas tú. HERMES_HOME queda fijo en /opt/data, y esa es la única ruta declarada como VOLUME. Todo lo demás bajo /opt/hermes, el venv, el bundle del frontend, la instalación misma, se copia de solo lectura (--chmod=a+rX,go-w) y es propiedad de root. Esa separación importa más adelante: el código es inmutable, el volumen de datos es lo único que necesitas conservar.
Hay un default fácil de asumir mal: meter a Hermes en un contenedor no pone, por sí solo, en sandbox lo que corre. El backend de ejecución de herramientas es local por defecto, lo que significa que un comando de shell que corre el agente se ejecuta dentro de este mismo contenedor, con el mismo filesystem y el mismo namespace de red que el propio Hermes. La imagen instala el paquete docker-cli como dependencia del sistema justo para el caso en que quieras más aislamiento que eso: apunta una tarea al backend docker en cambio, y Hermes llama a esa CLI para lanzar un contenedor hermano en sandbox (cap-drop all, sin privilegios nuevos, con límites de recursos) donde corre el comando. La forma usual de conectar eso desde dentro de un contenedor es montando el socket de Docker del host dentro del contenedor de Hermes. Local es el default. Descartable es una elección que haces por tarea.
El Docker Compose del repo, leído directo
El docker-compose.yml del repo hace build desde el código (build: .) y corre dos servicios, no uno. Para usar la imagen publicada, quita el build: . y apunta las dos líneas image: a nousresearch/hermes-agent:stable:
services:
gateway:
build: .
image: hermes-agent
container_name: hermes
restart: unless-stopped
network_mode: host
volumes:
- ~/.hermes:/opt/data
environment:
- HERMES_UID=${HERMES_UID:-10000}
- HERMES_GID=${HERMES_GID:-10000}
command: ["gateway", "run"]
dashboard:
image: hermes-agent
container_name: hermes-dashboard
restart: unless-stopped
network_mode: host
depends_on:
- gateway
volumes:
- ~/.hermes:/opt/data
environment:
- HERMES_UID=${HERMES_UID:-10000}
- HERMES_GID=${HERMES_GID:-10000}
command: ["dashboard", "--host", "127.0.0.1", "--no-open"]
Esa es la forma, recortada de los bloques comentados para las credenciales de Microsoft Teams y Google Chat, que son keys reales en el archivo (TEAMS_CLIENT_ID, GOOGLE_CHAT_SERVICE_ACCOUNT_JSON, y el resto), solo que opt-in. Los dos servicios montan la misma ruta del host en /opt/data, los dos corren con el mismo UID remapeado, y el gateway y el dashboard son contenedores separados a propósito que comparten un volumen de datos, en vez de un solo proceso haciendo los dos trabajos.
El comentario de arriba del propio archivo te dice cómo correrlo, pasando los IDs de tu usuario del host para que lo que es tuyo siga siendo tuyo también dentro del contenedor:
Levantar el stack
Gateway + dashboard
HERMES_UID=$(id -u) HERMES_GID=$(id -g) docker compose up -d
Sus notas de seguridad valen la pena leerse literalmente, porque son los dos errores que la gente realmente comete: el dashboard se bindea a 127.0.0.1 por diseño, porque guarda API keys, y el comentario es explícito en que el acceso remoto debería pasar por un túnel SSH o un reverse proxy que agregue autenticación, nunca pasando --insecure --host 0.0.0.0. Esa última parte ya no aplica: desde el hardening de junio de 2026, --insecure y HERMES_DASHBOARD_INSECURE no hacen nada (la env var registra un aviso y se ignora), y un bind fuera de loopback sin proveedor de auth falla cerrado al arrancar. La documentación explica por qué: dashboards expuestos y sin autenticación fueron la puerta de entrada de una campaña en junio de 2026 que llevó a agentes a plantar un backdoor de llave SSH. Cualquier guía que todavía te diga que pases --insecure está desactualizada. La segunda nota es sobre el servidor de API compatible con OpenAI, que se queda apagado a menos que descomentes API_SERVER_HOST y API_SERVER_KEY juntos, porque la key es obligatoria en el momento en que el servidor queda alcanzable más allá de localhost. La documentación actual también exige API_SERVER_ENABLED=true.
Persistir HERMES_HOME, y perfiles para instancias aisladas
Todo lo que hace que una instalación de Hermes sea tuya vive bajo HERMES_HOME: config.yaml, SOUL.md, MEMORY.md y USER.md, la carpeta skills/ y state.db. Monta ese único directorio y un rebuild del contenedor no pierde nada. Pierde ese mount y te queda una instalación nueva, sin memoria de haber corrido alguna vez.
Una trampa de filesystem en laptops: state.db corre en modo WAL de SQLite, y los bind mounts que cruzan el borde de una VM (virtiofs en Docker Desktop para macOS y en OrbStack, 9p en Docker Desktop para Windows) pueden dejar que escritores concurrentes corrompan la base mientras el archivo sigue pasando un integrity check. Desde v2026.9.14 Hermes crea una base nueva en esos mounts en modo rollback, y hermes doctor marca una base WAL que ya existía. En Mac, el arreglo limpio es un volumen con nombre (-v hermes-data:/opt/data). En un VPS Linux con un bind mount común, esto no aplica.
Si quieres más de un agente en la misma máquina, Hermes le llama a eso un perfil, y es un concepto de primera clase, no un workaround. Dentro del contenedor del gateway corriendo:
Crear un perfil aislado
Créalo
hermes profile create coderÚsalo
coder setup
Eso crea ~/.hermes/profiles/coder/ con su propio config.yaml, .env, SOUL.md y state.db, y además conecta un comando coder, un shortcut para hermes -p coder. Un perfil de asistente personal y un perfil de coding agent en el mismo host nunca comparten memoria, nunca comparten skills, y nunca escriben por accidente en el system prompt del otro, que es lo que realmente sale mal cuando dos agentes comparten un mismo home.
La imagen Docker está pensada justo para esto. El Dockerfile declara servicios s6 estáticos para el proceso principal de Hermes y el dashboard en tiempo de build, pero los servicios de gateway por perfil se registran dinámicamente en runtime bajo /run/service/, que es tmpfs y se borra en cada restart del contenedor. Un script de cont-init.d llamado 02-reconcile-profiles corre antes de que arranque cualquier otra cosa y reconstruye esos slots de servicio leyendo $HERMES_HOME/profiles/<name>/ desde el volumen montado. En la práctica: un contenedor, un volumen, tantas instancias aisladas de Hermes como perfiles tengas, sobreviviendo un restart sin que toques nada.
El dashboard y la web UI de Hermes Agent, detrás de auth
Fuera de un contenedor, el dashboard se bindea a loopback. Dentro de la imagen oficial se bindea a 0.0.0.0 para que un -p 9119:9119 publicado funcione, y ese bind fuera de loopback enciende el gate de auth: sin proveedor de auth registrado, no hay dashboard. La documentación lista tres proveedores incluidos:
Proveedores de auth del dashboard en la imagen oficial
| Proveedor | Cómo se enciende | Para qué sirve |
|---|---|---|
| Usuario y contraseña | HERMES_DASHBOARD_BASIC_AUTH_USERNAME + _PASSWORD (+ _SECRET para que la sesión sobreviva a un restart) | Homelab o una máquina detrás de una VPN. La documentación dice: no para internet abierto |
| OAuth (Nous Portal) | HERMES_DASHBOARD_OAUTH_CLIENT_ID | Deploys hosteados y públicos |
| OIDC self-hosted | HERMES_DASHBOARD_OIDC_ISSUER + HERMES_DASHBOARD_OIDC_CLIENT_ID | Tu propio proveedor de identidad |
Las keys de basic auth también existen en config.yaml bajo dashboard.basic_auth (username, password o password_hash, secret); las env vars ganan cuando están definidas. La otra salida es HERMES_DASHBOARD_HOST=127.0.0.1 y un túnel SSH o Tailscale.
Si un reverse proxy como Traefik corre en otro contenedor, el dashboard no confía en su dirección bridge por defecto. Dile en qué proxy creer en el config.yaml montado, con una IP exacta o un CIDR acotado (Hermes rechaza * y 0.0.0.0/0):
dashboard:
public_url: "https://dashboard.example.com"
trusted_proxies:
- "172.20.0.5"
Esta es la trampa, y no es específica de Hermes. La API nativa WebSocket de un navegador no tiene forma de poner un header Authorization en el handshake. Si un reverse proxy frente al dashboard protege cada ruta, incluidas las de WebSocket, con basic auth, las requests HTTP normales del navegador pasan (el navegador reenvía la credencial), pero el upgrade de WebSocket nunca la lleva, y la UI se queda colgada en “Connecting” para siempre. Me pasó corriendo Hermes detrás de Traefik: el arreglo fue un segundo router de Traefik acotado solo a la ruta de WebSocket, autenticado con un parámetro de query ?token= en vez de basic auth, saltándose por completo el primer router. La misma trampa afectó a la web UI de OpenClaw cuando la evalué la misma semana, que es como sé que es un patrón del edge, no un bug de ninguno de los dos proyectos.
El propio código de Hermes desde entonces formalizó la misma separación una capa más abajo, dentro del proceso del dashboard mismo. En modo gated, un upgrade de WebSocket nunca acepta el token de sesión plano del dashboard; un comentario en el código es explícito en que una constante filtrada no debe otorgar acceso por sí sola. En cambio, el navegador acuña un ticket de un solo uso con un TTL de 30 segundos y lo presenta como un parámetro de query ?ticket= o un subprotocolo hermes-gateway-ticket.<ticket>, un proceso hijo lanzado por el servidor recibe en cambio una credencial ?internal= de vida más larga, y una sesión con sign-in puede caer de vuelta en un ?token= verificado por provider, el mismo camino de verificación que usa el bearer auth de la REST API. Ninguno de los tres es un header, porque un header es exactamente lo que un handshake de WebSocket no puede llevar de forma confiable. La propia nota de historia del código lo dice sin vueltas: antes de que existiera ese camino de ticket, el upgrade de WebSocket en modo gated no tenía ninguna credencial que aceptara, y simplemente fallaba cerrado.
La lección se generaliza más allá de Hermes. Cada vez que pongas auth de estilo sesión frente a una conexión de larga duración, revisa si esa conexión es un WebSocket antes de asumir que la capa de auth la cubre. Si estás proxeando el dashboard tú mismo, dale a la ruta de WebSocket su propia ruta con token en vez de confiar en que el basic auth siga el upgrade.
Mi swarm: bento, Traefik, Portainer
Mi propio Hermes corre en un VPS que convertí en un Docker Swarm con bento, mi propio instalador, que pone Traefik y Portainer frente a lo que sea que despliegues. Hermes corre headless en ese swarm, con el gateway de Telegram activo, sin que se abra nunca una pestaña de navegador en la máquina misma. El archivo Compose de arriba es la forma de un solo host; Swarm cambia algunas cosas una vez que lo despliegas como un stack, y Portainer se vuelve lo que usas para redesplegar en vez de docker compose up directamente.
Las trampas que realmente cuestan tiempo
Ninguna de estas aparece en una demo. Todas aparecieron en un VPS real.
Síntoma, causa real, arreglo
| Lo que ves | Lo que realmente está pasando | Qué lo arregló |
|---|---|---|
| Un contenedor que se llama a sí mismo por su hostname público hace timeout | userland-proxy: false tira el camino de hairpin NAT en un VPS de una sola IP; el paquete sale por la interfaz pública y nunca vuelve a rutear | Quitar la key. El default de Docker en true es el setting correcto acá |
| Un servicio del mismo host tarda unos 130 segundos en responder, no menos de uno | Llamar a un contenedor por su FQDN público rutea por TLS de loopback en vez de por la red interna | Llamarlo por su nombre de servicio interno, no por su hostname público |
| Un contenedor simplemente desaparece, sin error en sus propios logs | El kernel lo mató por OOM. El orquestador solo ve process_lost con un exit code nulo | dmesg | grep oom es el log real. Nada de lo que imprime Docker lo nombra |
| Una llamada a un provider falla con un error de credencial doble | El SDK pone un header de auth desde una env var y un header explícito pone un segundo | Elige una sola fuente para la credencial, nunca las dos a la vez |
| Un servicio se queda en 0/1 réplicas y el proxy devuelve 404 | docker restart sobre una task de Swarm la deja huérfana en vez de reprogramarla | docker service update --force <service>. Nunca hagas docker restart sobre una task directamente |
| agent.log tira Permission denied | Un diagnóstico corrido como root dentro del contenedor dejó archivos propiedad de root en un directorio que el usuario del servicio no puede tocar | chown de los archivos afectados de vuelta al UID del servicio (10000 por defecto) |
Los dos arreglos que vale la pena tener a mano, los mismos dos cada vez:
Los dos comandos que realmente usas
Redesplegar un servicio de Swarm, nunca reiniciar una task
docker service update --force <service>Arreglar archivos de root bajo HERMES_HOME
chown -R 10000:10000 /opt/data
Un patrón más no es un bug, solo vale la pena nombrarlo. Cuando otro contenedor en la misma máquina necesita el binario de Hermes, la respuesta no es una segunda imagen. Injertar los propios volúmenes de la instalación que ya corre en el contenedor del otro servicio le da el binario y los datos sin un rebuild. Así es como los contenedores de mi empresa de agentes en Paperclip llaman a Hermes: los volúmenes los injerta el instalador de bento después de que los dos stacks ya están desplegados, porque Compose solo no tiene una forma limpia de expresar “monta el volumen de este otro stack” cuando el orden de deploy entre los dos stacks no está fijo.
El mejor VPS para Hermes Agent: requisitos, no marcas
No hay ningún provider que vaya a nombrar acá, y una lista de “mejor VPS” es casi siempre copy de afiliados disfrazado de review. Lo que realmente importa, en orden:
Lo que realmente necesita un host para Hermes Agent
- Una sola IP pública sobre la que controlas el comportamiento de NAT de DockerVPS de una sola IP más userland-proxy: false es la combinación exacta que rompe el hairpin NAT. Sabe cuál de las dos estás alquilando antes de tocar ese setting.
- Margen de memoria independiente de la carga de trabajo propia del agenteEl dashboard tiene un memory leak abierto ligado a sesiones en vivo, no a tiempo inactivo, y ha llegado a varios gigabytes en una hora en una instalación real. Dimensiona ese proceso por separado del gateway. La documentación pone el mínimo en 1 GB y recomienda de 2 a 4 GB, al menos 2 GB cuando corren las herramientas de browser.
- Soporte para Swarm o Compose, y un usuario de servicio sin privilegios de rootLa imagen ya cae a UID 10000 por ti. Un host que fuerza todo por root deshace esa protección la primera vez que alguien corre un comando puntual como root dentro del contenedor.
- Acceso por SSH key, no una consola solo de navegadorTodo esto, el archivo Compose, los comandos de Swarm, los arreglos de chown, asume una shell real. Una consola de provider que solo te da una terminal web hace que cada una de estas trampas sea más lenta de arreglar.
- Storage en bloque persistente que de verdad respaldasHERMES_HOME es el único volumen que importa. Si el storage del host desaparece con la instancia, también desaparece cada perfil que tenías ahí.
Upgrade sin perder nada
La imagen no guarda estado. Todo lo que importa está en /opt/data, así que un upgrade es pull, recrear, listo. En el primer arranque del contenedor nuevo, Hermes corre las migraciones de schema contra el config.yaml montado y guarda backups con timestamp de config.yaml y .env antes de tocar cualquiera de los dos. Igual hago mi propia copia del directorio entero antes, porque esos backups no cubren state.db ni la memoria.
Upgrade de la imagen oficial
Backup de HERMES_HOME antes (costumbre mía, no un paso de la documentación)
tar czf hermes-backup-$(date +%F).tgz -C ~ .hermesCompose: baja la imagen nueva
docker compose pullCompose: recrea el contenedor
docker compose up -dConfirma en qué versión quedaste
docker run -it --rm nousresearch/hermes-agent:latest --version
Los gateways que estaban corriendo vuelven solos: el reconciler de arranque reinicia cada perfil cuyo último estado registrado era running. Solo un gateway que paraste con hermes gateway stop queda parado. Define HERMES_SKIP_CONFIG_MIGRATION=1 si quieres leer la migración antes de que la imagen nueva reescriba tu config.
Fija una versión, y después lee las notas de la release
El dashboard tiene su propio bug abierto. El Issue #80527, todavía abierto y marcado P2 el 13/10/2026, reporta que su proceso crece sin límite mientras sirve sesiones en vivo, desde una base estable de unos 250 MB hasta 6,3 GB en una ocurrencia y 7,6 GB, con el swap totalmente agotado, en otra, las dos terminando en un OOM kill que tiró abajo cada cliente conectado a través de él. Quien lo reportó rastreó la causa probable hasta tui_gateway/server.py: la transcripción cruda de la sesión se retiene en memoria para resume y durabilidad incluso después de que la compresión de contexto reemplaza lo que el agente mismo ve, y una sesión larga con mucho output de herramientas hace crecer esa copia retenida sin límite de tamaño. El mismo dashboard sin ninguna sesión activa se mantiene plano en unos 290 MB, así que el leak solo aparece cuando de verdad usas la UI por un rato.
Dos pull requests abiertos lo atacan: el #100131, un watchdog de memoria dentro del proceso que sale de forma controlada antes del OOM kill del kernel, y el #63551, un arreglo para el reaper de sesiones inactivas, que nunca se dispara mientras un cliente sigue conectado. Ninguno estaba mergeado el 13/10/2026.
Hasta que entre un arreglo, la regla de operación es aburrida a propósito: fija el digest de imagen que probaste, lee las notas antes de subirlo de versión, y en un VPS con poca memoria, no dejes una sesión larga de dashboard abierta sin supervisión por horas. Reinicia el dashboard con un horario si tienes que dejarlo corriendo. El proceso del gateway, donde viven tus gateways de chat y tus cron jobs, no es el que tiene este bug.
Hermes Agent en Docker, respuestas rápidas
¿Puedo correr Hermes Agent en Docker?
Sí. Nous Research publica una imagen oficial, nousresearch/hermes-agent (tags stable y latest, v0.21.7 el 13/10/2026). Monta un directorio del host en /opt/data, corre la imagen con setup una vez y después con gateway run. Define HERMES_DASHBOARD=1 para tener el dashboard en el puerto 9119. La imagen corre bajo s6-overlay como un usuario sin privilegios de root.
¿Cómo persisto los datos de Hermes Agent en Docker?
Monta una ruta del host en /opt/data, que es donde vive HERMES_HOME dentro del contenedor (el archivo compose incluido usa ~/.hermes:/opt/data). Ese único volumen guarda config.yaml, SOUL.md, memoria, skills y state.db. Todo lo demás en la imagen es reemplazable.
¿Por qué mi dashboard de Hermes Agent se queda colgado en Connecting?
Casi siempre es un reverse proxy protegiendo el dashboard con basic auth frente a su ruta de WebSocket. Los navegadores no pueden enviar un header Authorization en un upgrade de WebSocket, así que las rutas HTTP normales autentican bien y la ruta de WebSocket se queda colgada para siempre. Dale a la ruta de WebSocket su propia ruta basada en token, en vez de basic auth.
¿Cuál es el mejor VPS para Hermes Agent?
No hay una respuesta de marca. Lo que importa es una sola IP pública sobre la que entiendes los settings de NAT de Docker, margen de memoria dimensionado para el proceso propio del dashboard por separado de la carga del agente, soporte para Swarm o Compose con un usuario de servicio sin privilegios de root, acceso SSH real, y storage persistente que respaldas.
¿Puedo correr varias instancias de Hermes Agent en un solo VPS?
Sí, con perfiles. hermes profile create <name> le da a cada instancia su propio directorio home, config, memoria y base de datos de estado bajo HERMES_HOME/profiles/, y la imagen Docker reconcilia los servicios de gateway por perfil desde ese directorio en cada restart del contenedor.
La newsletter
Don’t Code, Specify. Cada semana, agentes de IA en producción de verdad. Sin hype: lo que funcionó y lo que se rompió.
Suscríbete en Substack (se abre en una pestaña nueva)