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

QNAP NAS에 Hermes Agent를 배포하고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.

첫 실행 시, Compose 파일에 볼륨 경로가 선언되면Container Station이 자동으로hermes-data폴더를 생성합니다. 사전 폴더 생성이나 SSH 접근이 필요하지 않습니다. 또는, File Station를 통해 사전에 폴더를 생성할 수 있습니다.

1. QNAP 웹 인터페이스에서Container Station을 엽니다.
2. 응용 프로그램으로 이동하고생성을 클릭합니다.
3. 응용 프로그램 생성 을 선택하고 다음의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. 생성을 클릭합니다. Container Station이 이미지를 가져오고 컨테이너를 시작합니다. hermes-data폴더는/share/Container/hermes-data에 자동으로 생성됩니다.
6. 컨테이너목록을 확인하여 컨테이너가 실행 중인지 확인합니다. 상태는실행 중으로 표시되어야 합니다.

참고: 모든 자격 증명은 2단계의 설정 마법사에 의해 관리되며 데이터 볼륨에 저장됩니다. 

컨테이너가 실행된 후, 대화형 셸 세션을 열어 첫 번째 구성을 완료합니다. 설정 마법사는 LLM 공급자, API 키 및 메시징 플랫폼 토큰을 구성하고 모든 설정을 지속 데이터 볼륨에 기록합니다.

1. Container Station에서hermes컨테이너를 선택합니다.
2. 실행을 클릭하고/bin/bash (또는 bash가 없으면/bin/sh)을 선택하여 대화형 셸을 엽니다.
3. 셸에서 실행합니다:
   hermes setup

4. 

   

5. 화면의 메시지에 따라 구성합니다:
   • LLM 공급자 및 모델(예: OpenAI, Anthropic, OpenAI Codex)
   • API 키
   • 메시징 플랫폼(예: Telegram 봇 토큰) — 이 단계에서 권장됨
6. 마법사가 설정을/opt/data/config.yaml및/opt/data/.env에 기록합니다. 이 단계는 한 번만 수행하면 됩니다.
7. 마법사가 완료되면exit를 입력하여 셸을 닫고, 구성을 적용하기 위해Container Station를 통해 컨테이너를 다시 시작합니다.

1. Container Station에서hermes컨테이너를 선택하고Logs를 클릭합니다.
2. 출력에 다음 줄이 나타나는지 확인합니다:
   Hermes Gateway Starting...
3. Execute를 클릭하고/bin/bash (또는 bash가 없으면/bin/sh)를 선택하여 대화형 셸을 엽니다.
4. 셸에서 실행합니다:  hermes 
5. 그런 다음 대화할 수 있습니다.
6. Telegram을 사용하는 경우, 구성된 봇에 메시지를 보내 연결을 확인합니다.

hermes model명령을 사용하여 언제든지 공급자나 모델을 대화형으로 전환합니다.

1. Container Station에서hermes컨테이너를 선택합니다.
2. Execute를 클릭하고/bin/bash (또는/bin/sh )를 선택합니다.
3. 터미널 세션에서 실행합니다:
   hermes model
4. 대화형 메시지에 따라 새 공급자와 모델을 선택합니다. 선택 사항은config.yaml에 자동으로 저장됩니다.

지원되는 제공업체에는anthropic, openai-codex, openai, openrouter, nous, deepseek, minimax등이 포함됩니다. 전체 목록은공식 CLI 참조을 참조하세요.

hermes setup gateway을 사용하여 전체 설정 마법사를 다시 실행하지 않고도 메시징 통합(Telegram, Discord, Slack, WhatsApp, Signal 등)을 추가하거나 업데이트합니다.

1. Container Station에서hermes컨테이너를 선택합니다.
2. Execute를 클릭하고/bin/bash를 선택합니다.
3. 실행:
   hermes setup gateway
4. 메시징 플랫폼 자격 증명을 추가하거나 업데이트하려면 지침을 따르세요.
5. 마법사를 완료한 후 컨테이너를 재시작합니다:
   exit
   그런 다음Container Station을 통해 재시작합니다 — 컨테이너를 선택하고Restart를 클릭합니다.

설정의 일부(모델, 터미널 백엔드, 도구, 게이트웨이, 에이전트 성격)를 재구성하려면 전체 마법사 또는 특정 섹션을 실행합니다:

1. Container Station Execute를 통해 컨테이너에서 셸을 엽니다.
2. 전체 마법사 실행:
   hermes setup
3. 또는 특정 섹션만 실행:
   • hermes setup model — LLM 제공업체 및 모델
   • hermes setup gateway — 메시징 플랫폼 구성
   • hermes setup tools — 도구 활성화 또는 비활성화
   • hermes setup terminal — 터미널 백엔드(로컬, Docker샌드박스, SSH)
   • hermes setup agent — 에이전트 정체성과 성격(SOUL.md)
4. 변경 사항을 적용한 후 컨테이너를 재시작합니다.