Docker Deployment

Why Docker?

• Reproducible — Same environment everywhere
• Isolated — No conflicts with system packages
• Easy — One command to start
• Scalable — Run multiple instances easily

Quick Start

docker pull nousresearch/hermes-agent:latest
docker run -it \
  -v ~/.hermes:/root/.hermes \
  -p 8080:8080 \
  nousresearch/hermes-agent:latest

Docker Compose (Recommended)

Create a docker-compose.yml:

version: '3.8'
services:
  hermes-agent:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-agent
    restart: unless-stopped
    volumes:
      - ./hermes-data:/root/.hermes
    ports:
      - "8080:8080"
    environment:
      - TZ=Asia/Shanghai

Start:

docker compose up -d

Using Specific Versions

# Pin to a specific version
docker pull nousresearch/hermes-agent:v0.13.0

# Or in docker-compose.yml
image: nousresearch/hermes-agent:v0.13.0

Data Persistence

Mount the ~/.hermes directory to persist your data:

docker run -it \
  -v /path/to/hermes-data:/root/.hermes \
  nousresearch/hermes-agent:latest

⚠️ Important: Do not mount the same data directory to multiple running containers simultaneously.

Environment Variables

Variable	Default	Description
HERMES_CONFIG	/root/.hermes/config.yaml	Config file path
TZ	UTC	Timezone
HERMES_LOG_LEVEL	INFO	Log level

Health Check

docker exec hermes-agent hermes doctor

Next Steps

• Model Configuration — Set up your LLM
• Advanced Config — Fine-tune your setup