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

Come distribuire e configurare Hermes Agent su 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 creerà automaticamente la cartella hermes-data al primo avvio quando il percorso del volume è dichiarato nel file Compose. Non è necessaria la creazione preventiva della cartella o l'accesso SSH. In alternativa, la cartella può essere creata in anticipo tramite File Station.

1. Aprire Container Station nell'interfaccia web QNAP.
2. Andare su Applicazioni e fare clic su Crea.
3. Selezionare Crea Applicazione  e incollare il seguente YAML di 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. Fare clic su Crea. Container Station scaricherà l'immagine e avvierà il container. La cartella hermes-data sarà creata automaticamente in /share/Container/hermes-data.
6. Verificare che il container sia in esecuzione controllando l'elenco Containers. Lo stato dovrebbe mostrare In esecuzione.

Nota: Tutte le credenziali sono gestite dal wizard di configurazione nella Fase 2 e memorizzate nel volume dati. 

Dopo che il container è in esecuzione, aprire una sessione shell interattiva per completare la configurazione iniziale. Il wizard di configurazione imposta il tuo fornitore LLM, le chiavi API e i token della piattaforma di messaggistica, scrivendo tutte le impostazioni nel volume dati persistente.

1. In Container Station, selezionare il container hermes.
2. Fare clic su Esegui e selezionare /bin/bash (o /bin/sh se bash non è disponibile) per aprire una shell interattiva.
3. Nella shell, eseguire:
   hermes setup

4. 

   

5. Segui le istruzioni sullo schermo per configurare:
   • Provider e modello LLM (ad es., OpenAI, Anthropic, OpenAI Codex)
   • Chiavi API
   • Piattaforma di messaggistica (ad es., token bot Telegram) — consigliato in questa fase
6. Il wizard scrive le tue impostazioni su /opt/data/config.yaml e /opt/data/.env. Questo passaggio deve essere eseguito solo una volta.
7. Dopo che il wizard è completato, digita exit per chiudere la shell, quindi riavvia il container tramite Container Station per applicare la configurazione.

1. In Container Station, seleziona il container hermes e fai clic su Logs.
2. Conferma che le seguenti righe appaiano nell'output:
   Hermes Gateway Starting...
3. Fai clic su Execute e seleziona /bin/bash (o /bin/sh se bash non è disponibile) per aprire una shell interattiva.
4. Nella shell, esegui:  hermes 
5. Quindi puoi parlarci.
6. Se usi Telegram, invia un messaggio al tuo bot configurato per verificare la connessione.

Usa il comando hermes model per cambiare interattivamente provider o modelli in qualsiasi momento.

1. In Container Station, seleziona il container hermes.
2. Fai clic su Execute e seleziona /bin/bash (o /bin/sh  ).
3. Nella sessione terminale, esegui:
   hermes model
4. Segui le istruzioni interattive per selezionare un nuovo provider e modello. La selezione viene salvata su config.yaml automaticamente.

I provider supportati includono: anthropic, openai-codex, openai, openrouter, nous, deepseek, minimax e altri. Per l'elenco completo, fare riferimento al riferimento ufficiale CLI.

Usa hermes setup gateway per aggiungere o aggiornare le integrazioni di messaggistica (Telegram, Discord, Slack, WhatsApp, Signal, ecc.) senza eseguire nuovamente la procedura guidata completa.

1. In Container Station, seleziona il container hermes.
2. Fai clic su Esegui e seleziona /bin/bash.
3. Esegui:
   hermes setup gateway
4. Segui le istruzioni per aggiungere o aggiornare le credenziali della tua piattaforma di messaggistica.
5. Riavvia il container dopo aver completato la procedura guidata:
   exit
   Poi riavvia tramite Container Station — seleziona il container e fai clic su Riavvia.

Per riconfigurare qualsiasi parte dell'installazione (modello, backend del terminale, strumenti, gateway, personalità dell'agente), esegui la procedura guidata completa o una sezione specifica:

1. Apri una shell nel container tramite Container Station Esegui.
2. Esegui la procedura guidata completa:
   hermes setup
3. Oppure esegui solo una sezione specifica:
   • hermes setup model — Fornitore e modello LLM
   • hermes setup gateway — Configurazione della piattaforma di messaggistica
   • hermes setup tools — Abilita o disabilita strumenti
   • hermes setup terminal — Backend del terminale (locale, Docker sandbox, SSH)
   • hermes setup agent — Identità e personalità dell'agente (SOUL.md)
4. Riavvia il container dopo aver apportato modifiche.