How to Deploy and Configure Hermes Agent on QNAP NAS with Container Station

Cómo desplegar y configurar Hermes Agent en QNAP NAS con Container Station

Container Station will automatically create the hermes-data folder on first run when the volume path is declared in the Compose file. No prior folder creation or SSH access is required. Alternatively, the folder can be created in advance via File Station.

1. Open Container Station in the QNAP web interface.
2. Navigate to Applications and click Create.
3. Select Create Application and paste the following Docker Compose YAML:

4. version: "3.8"
   
   services:
     hermes:
       image: nousresearch/hermes-agent:latest
       container_name: hermes
       restart: unless-stopped
       command: gateway run
       volumes:
         - /share/Container/hermes-data:/opt/data
   
   

5. Click Create. Container Station will pull the image and start the container. The hermes-data folder will be created automatically at /share/Container/hermes-data.
6. Verify the container is running by checking the Containers list. The status should show Running.

Note: All credentials are managed by the setup wizard in Step 2 and stored in the data volume. 

After the container is running, open an interactive shell session to complete first-time configuration. The setup wizard configures your LLM provider, API keys, and messaging platform tokens, writing all settings to the persistent data volume.

1. In Container Station, select the hermes container.
2. Click Execute and select /bin/bash (or /bin/sh if bash is unavailable) to open an interactive shell.
3. In the shell, run:
   hermes setup

4. 

   

5. Follow the on-screen prompts to configure:
   • LLM provider and model (e.g., OpenAI, Anthropic, OpenAI Codex)
   • API keys
   • Messaging platform (e.g., Telegram bot token) — recommended at this stage
6. The wizard writes your settings to /opt/data/config.yaml and /opt/data/.env. This step only needs to be performed once.
7. After the wizard completes, type exit to close the shell, then restart the container via Container Station to apply the configuration.

1. In Container Station, select the hermes container and click Logs.
2. Confirm the following lines appear in the output:
   Hermes Gateway Starting...
3. Click Execute and select /bin/bash (or /bin/sh if bash is unavailable) to open an interactive shell.
4. In the shell, run:  hermes 
5. Then you can talk to it.
6. If using Telegram, send a message to your configured bot to verify the connection.

Use the hermes model command to interactively switch providers or models at any time.

1. In Container Station, select the hermes container.
2. Click Execute and select /bin/bash (or /bin/sh ).
3. In the terminal session, run:
   hermes model
4. Follow the interactive prompts to select a new provider and model. The selection is saved to config.yaml automatically.

Supported providers include: anthropic, openai-codex, openai, openrouter, nous, deepseek, minimax, and others. For a full list, refer to the official CLI reference.

Use hermes setup gateway to add or update messaging integrations (Telegram, Discord, Slack, WhatsApp, Signal, etc.) without re-running the full setup wizard.

1. In Container Station, select the hermes container.
2. Click Execute and select /bin/bash.
3. Run:
   hermes setup gateway
4. Follow the prompts to add or update your messaging platform credentials.
5. Restart the container after completing the wizard:
   exit
   Then restart via Container Station — select the container and click Restart.

To reconfigure any part of the setup (model, terminal backend, tools, gateway, agent personality), run the full wizard or a specific section:

1. Open a shell in the container via Container Station Execute.
2. Run the full wizard:
   hermes setup
3. Or run a specific section only:
   • hermes setup model — LLM provider and model
   • hermes setup gateway — Messaging platform configuration
   • hermes setup tools — Enable or disable tools
   • hermes setup terminal — Terminal backend (local, Docker sandbox, SSH)
   • hermes setup agent — Agent identity and personality (SOUL.md)
4. Restart the container after making changes.

Container Station creará automáticamente la carpeta hermes-data en la primera ejecución cuando se declare la ruta del volumen en el archivo Compose. No se requiere creación previa de carpetas ni acceso SSH. Alternativamente, la carpeta se puede crear por adelantado a través de File Station.

1. Abra Container Station en la interfaz web de QNAP.
2. Navegue a Aplicaciones y haga clic en Crear.
3. Seleccione Crear aplicación  y pegue el siguiente YAML de Docker Compose:

4. version: "3.8"
   
   services:
     hermes:
       image: nousresearch/hermes-agent:latest
       container_name: hermes
       restart: unless-stopped
       command: gateway run
       volumes:
         - /share/Container/hermes-data:/opt/data

5. Haga clic en Crear. Container Station descargará la imagen e iniciará el contenedor. La carpeta hermes-data se creará automáticamente en /share/Container/hermes-data.
6. Verifique que el contenedor esté en ejecución comprobando la lista de Contenedores. El estado debería mostrar En ejecución.

Nota: Todas las credenciales son gestionadas por el asistente de configuración en el Paso 2 y se almacenan en el volumen de datos. 

Después de que el contenedor esté en ejecución, abra una sesión de shell interactiva para completar la configuración inicial. El asistente de configuración configura su proveedor de LLM, claves API y tokens de la plataforma de mensajería, escribiendo todos los ajustes en el volumen de datos persistente.

1. En Container Station, seleccione el contenedor hermes.
2. Haga clic en Ejecutar y seleccione /bin/bash (o /bin/sh si bash no está disponible) para abrir un shell interactivo.
3. En el shell, ejecute:
   hermes setup

4. 

   

5. Siga las indicaciones en pantalla para configurar:
   • Proveedor y modelo de LLM (por ejemplo, OpenAI, Anthropic, OpenAI Codex)
   • Claves API
   • Plataforma de mensajería (por ejemplo, token de bot de Telegram) — recomendado en esta etapa
6. El asistente escribe sus configuraciones en /opt/data/config.yaml y /opt/data/.env. Este paso solo necesita realizarse una vez.
7. Después de que el asistente termine, escriba exit para cerrar el shell, luego reinicie el contenedor a través de Container Station para aplicar la configuración.

1. En Container Station, seleccione el contenedor hermes y haga clic en Logs.
2. Confirme que las siguientes líneas aparezcan en la salida:
   Hermes Gateway Starting...
3. Haga clic en Execute y seleccione /bin/bash (o /bin/sh si bash no está disponible) para abrir un shell interactivo.
4. En el shell, ejecute:  hermes 
5. Entonces puede hablar con él.
6. Si usa Telegram, envíe un mensaje a su bot configurado para verificar la conexión.

Use el comando hermes model para cambiar interactivamente de proveedores o modelos en cualquier momento.

1. En Container Station, seleccione el contenedor hermes.
2. Haga clic en Execute y seleccione /bin/bash (o /bin/sh  ).
3. En la sesión de terminal, ejecute:
   hermes model
4. Siga las indicaciones interactivas para seleccionar un nuevo proveedor y modelo. La selección se guarda en config.yaml automáticamente.

Los proveedores compatibles incluyen: anthropic, openai-codex, openai, openrouter, nous, deepseek, minimax, y otros. Para una lista completa, consulte el referencia oficial de CLI.

Utilice hermes setup gateway para añadir o actualizar integraciones de mensajería (Telegram, Discord, Slack, WhatsApp, Signal, etc.) sin volver a ejecutar el asistente de configuración completo.

1. En Container Station, seleccione el contenedor hermes.
2. Haga clic en Ejecutar y seleccione /bin/bash.
3. Ejecute:
   hermes setup gateway
4. Siga las indicaciones para añadir o actualizar las credenciales de su plataforma de mensajería.
5. Reinicie el contenedor después de completar el asistente:
   exit
   Luego reinicie a través de Container Station — seleccione el contenedor y haga clic en Reiniciar.

Para reconfigurar cualquier parte de la configuración (modelo, backend de terminal, herramientas, gateway, personalidad del agente), ejecute el asistente completo o una sección específica:

1. Abra un shell en el contenedor a través de Container Station Ejecutar.
2. Ejecute el asistente completo:
   hermes setup
3. O ejecute solo una sección específica:
   • hermes setup model — Proveedor y modelo de LLM
   • hermes setup gateway — Configuración de la plataforma de mensajería
   • hermes setup tools — Habilitar o deshabilitar herramientas
   • hermes setup terminal — Backend de terminal (local, Docker sandbox, SSH)
   • hermes setup agent — Identidad y personalidad del agente (SOUL.md)
4. Reinicie el contenedor después de realizar cambios.