Files
hermesandadmin 82487b1565
release / build (push) Successful in 2m50s
[ready-to-test] feat(hermes): use NFS volumes on odroid SSD (#46)
## Summary

Configure the `hermes` stack persistent volumes as NFS-backed volumes on the SSD of `odroid`.

Changed only:

- `hermes_gateway_data` → `192.168.1.96:/root/volumes/hermes/gateway`
- `hermes_agent_data` → `192.168.1.96:/root/volumes/hermes/agent`

`hermes_squid` is not included.

## Validation

- `docker stack config -c poc/hermes/stack-compose.yml` succeeds.
- `git diff --check` succeeds.
- Diff contains only `poc/hermes/stack-compose.yml`.

## Deployment prerequisite

Before deploy, prepare the NFS export and copy the existing local volumes according to issue #45:

#45

Do not deploy before verifying the copy, NFS access from `rudolf-T`, and the absence of concurrent writes to the old volumes.

## Tracking

Resolves the storage work in admin/ansible#45:
#45
Co-authored-by: hermes <rudolfss13@gmail.com>
Reviewed-on: #46
Co-authored-by: hermes <rudolfss13+hermes@gmail.com>
2026-09-24 23:50:41 +02:00
..
2026-06-28 22:41:16 +02:00

Hermes Docker Swarm stack

Deploy Hermes agent and gateway with GitHub Copilot and Telegram chat integration.

This stack uses the official Hermes Docker image from Nous Research: nousresearch/hermes-agent:latest.

The browser-accessible Hermes dashboard is published on host port 8087.

Usage

  1. Create Docker secrets for the required credentials:
docker secret create hermes_github_copilot_api_key /path/to/copilot-key.txt
docker secret create hermes_telegram_bot_token /path/to/telegram-bot-token.txt
docker secret create hermes_telegram_chat_id /path/to/chat-id.txt
docker secret create hermes_telegram_allow_from /path/to/telegram-allow-from.txt
  1. Create Docker secrets from the provided keys:
docker secret rm hermes_telegram_bot_token
docker secret rm hermes_telegram_chat_id
docker secret rm hermes_telegram_allow_from
docker secret rm hermes_github_copilot_api_key


echo -n '<TODO>' | docker secret create hermes_telegram_bot_token -
echo -n '<TODO>' | docker secret create hermes_telegram_chat_id -
echo -n '<TODO>' | docker secret create hermes_telegram_allow_from -
echo -n '<TODO>' | docker secret create hermes_github_copilot_api_key -
  1. Deploy the stack:
docker stack deploy -c stack-compose.yml hermes
  1. Verify services:
docker stack services hermes

Configuration

  • GITHUB_COPILOT_API_KEY is provided to both Hermes services via secret.
  • TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID are provided via secrets.
  • hermes-gateway listens on port 8080 and connects to hermes-agent.
  • Replace the image references with your actual Hermes Agent and Gateway images if needed.