DEV Community

zac
zac

Posted on • Originally published at remoteopenclaw.com

How to Self-Host Hermes Agent on a $5 VPS

#claude #ai #productivity #tutorial

Originally published on Remote OpenClaw.

Self-hosting Hermes Agent on a $5/month VPS gives you a fully autonomous AI agent with persistent memory, a built-in learning loop, and multi-platform messaging — all running on hardware you control. As of April 2026, the minimum viable setup requires a 1 vCPU / 2 GB RAM VPS, Docker, and an API key for your chosen LLM provider.

This guide walks through every step: choosing a VPS provider, installing Docker, deploying Hermes Agent, configuring a domain with SSL, and setting up basic monitoring. The entire process takes approximately 20-30 minutes for someone comfortable with a Linux terminal.

Key Takeaways

  • Hermes Agent runs on any VPS with 1+ vCPU and 2+ GB RAM — Hetzner, Hostinger, and DigitalOcean all work.
  • Docker is the recommended deployment method; the official image is nousresearch/hermes-agent:latest.
  • Total cost ranges from $5-7/month (VPS) plus $2-15/month for LLM API calls depending on model choice.
  • The one-line installer handles Linux, macOS, and WSL2 automatically.
  • Caddy reverse proxy with Let's Encrypt provides free automatic SSL for the web UI and API.

In this guide

  1. Choosing a VPS Provider
  2. VPS Cost Breakdown
  3. Docker Installation and Setup
  4. Deploying Hermes Agent
  5. Domain and SSL Configuration
  6. Monitoring and Maintenance
  7. Limitations and Tradeoffs
  8. FAQ

Choosing a VPS Provider

Three VPS providers consistently deliver the best price-to-performance ratio for self-hosting Hermes Agent in 2026: Hetzner, Hostinger, and DigitalOcean. Each has distinct advantages depending on your priorities.

Hetzner offers the lowest prices in Europe with AMD EPYC-powered shared vCPU servers. The CX22 plan (2 vCPU, 4 GB RAM, 40 GB NVMe) starts at approximately $4/month, making it the budget champion. Hetzner datacenters are located in Germany, Finland, and the US (Ashburn and Hillsboro).

Hostinger provides the easiest onboarding with one-click Docker templates and a built-in AI assistant. Their KVM 1 plan (1 vCPU, 4 GB RAM, 50 GB NVMe) starts at $4.99/month on a 24-month term. Hostinger also offers a dedicated Hermes Agent template for one-click deployment.

DigitalOcean has the most mature documentation ecosystem and the widest developer community. Their basic droplet (1 vCPU, 1 GB RAM, 25 GB SSD) starts at $6/month, though you will want at least the 2 GB RAM tier for Hermes Agent.

Minimum VPS Requirements

Hermes Agent without browser tools needs 1 vCPU and approximately 1 GB of RAM. With browser automation (Camofox or Chrome CDP) active, allocate at least 2 vCPUs and 4 GB RAM. Storage is modest — the agent, Docker overhead, and SQLite memory database fit comfortably in 20 GB.

VPS Cost Breakdown

Monthly VPS costs for running Hermes Agent range from under $4 to $25 depending on provider, specs, and billing term. The table below compares the most relevant plans as of April 2026.

Provider

Plan

vCPU

RAM

Storage

Price/Month

Best For

Hetzner

CX22

2

4 GB

40 GB NVMe

~$4

Budget deployments

Hetzner

CX32

4

8 GB

80 GB NVMe

~$7

Browser automation

Hostinger

KVM 1

1

4 GB

50 GB NVMe

$4.99

Easy setup

Hostinger

KVM 2

2

8 GB

100 GB NVMe

$6.99

Production workloads

DigitalOcean

Basic

1

2 GB

50 GB SSD

$12

US/global presence

DigitalOcean

Basic

2

4 GB

80 GB SSD

$24

Heavy workloads

Hostinger and Hetzner both offer promotional pricing on longer billing terms. Hostinger's renewal rates increase significantly (up to 140-230% above introductory pricing), so factor in renewal costs when comparing. For a broader comparison of self-hosted AI versus cloud-hosted options, see our dedicated guide.

Docker Installation and Setup

Docker is the recommended deployment method for Hermes Agent in production environments. It provides process isolation, reproducible builds, and simplified updates through image pulls.

Installing Docker on Ubuntu

After provisioning your VPS and connecting via SSH, install Docker Engine. The official Docker install script is the fastest path on Ubuntu 22.04 or 24.04 LTS:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
docker --version
Enter fullscreen mode Exit fullscreen mode

Installing Docker Compose

Docker Compose simplifies multi-container management and is used by the Hermes Agent docker-compose.yml template:

sudo apt-get install docker-compose-plugin
docker compose version
Enter fullscreen mode Exit fullscreen mode

Verify both commands return version numbers before proceeding. If you prefer running agents locally instead of on a VPS, the same Docker setup works on macOS and WSL2.

Deploying Hermes Agent

Hermes Agent provides an official Docker image at nousresearch/hermes-agent:latest on Docker Hub. Deployment involves creating a data directory, running the setup wizard, and then starting the agent in gateway mode.

Step 1: Create the Data Directory 

mkdir -p ~/.hermes
Enter fullscreen mode Exit fullscreen mode

Step 2: Run the Setup Wizard 

docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup
Enter fullscreen mode Exit fullscreen mode

The wizard prompts for your LLM provider API keys and writes them to ~/.hermes/.env. You can configure multiple providers (OpenAI, Anthropic, OpenRouter, Ollama) during this step.

Step 3: Create docker-compose.yml 

version: "3.8"
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    command: gateway run
    volumes:
      - ~/.hermes:/opt/data
    ports:
      - "3000:3000"
    restart: unless-stopped
    env_file:
      - ~/.hermes/.env
Enter fullscreen mode Exit fullscreen mode

Step 4: Start the Agent 

docker compose up -d
docker compose logs -f hermes
Enter fullscreen mode Exit fullscreen mode

The gateway run command starts the unified gateway, enabling simultaneous connections to Telegram, Discord, Slack, and other configured platforms. The agent is now running and accessible on port 3000.

Alternative: One-Line Installer

If you prefer a bare-metal installation without Docker, Hermes Agent provides a one-line installer:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

This script handles platform detection and installs all dependencies. It works on Linux, macOS, and WSL2.

Marketplace

Free skills and AI personas for OpenClaw — browse the marketplace.

Browse the Marketplace →

Domain and SSL Configuration

A domain with SSL is required if you want to expose the Hermes Agent web UI, API server, or webhook endpoints over HTTPS. For messaging-only deployments (Telegram, Discord), this step is optional.

Setting Up Caddy as a Reverse Proxy

Caddy automatically provisions and renews Let's Encrypt SSL certificates. Install it and create a Caddyfile:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update && sudo apt install caddy
Enter fullscreen mode Exit fullscreen mode

Create /etc/caddy/Caddyfile:

hermes.yourdomain.com {
    reverse_proxy localhost:3000
}
Enter fullscreen mode Exit fullscreen mode

Reload Caddy and it will automatically obtain an SSL certificate from Let's Encrypt:

sudo systemctl reload caddy
Enter fullscreen mode Exit fullscreen mode

Point your domain's A record to your VPS IP address before running this step. DNS propagation typically takes 5-30 minutes.

Monitoring and Maintenance

A self-hosted Hermes Agent needs basic monitoring to catch crashes, resource exhaustion, and certificate expiry. Three approaches cover most use cases without additional cost.

Docker Health Checks

Add a health check to your docker-compose.yml to enable automatic restarts on failure:

    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 60s
      timeout: 10s
      retries: 3
Enter fullscreen mode Exit fullscreen mode

Log Monitoring

Hermes Agent logs to stdout by default. Use Docker's built-in log rotation to prevent disk exhaustion:

    logging:
      driver: json-file
      options:
        max-size: "50m"
        max-file: "3"
Enter fullscreen mode Exit fullscreen mode

Uptime Monitoring

Free services like UptimeRobot can ping your Hermes Agent health endpoint every 5 minutes and alert you via email or Telegram if the agent goes down.

Updating Hermes Agent

To update to the latest version, pull the new image and restart:

docker compose pull
docker compose up -d
Enter fullscreen mode Exit fullscreen mode

Your data persists in the ~/.hermes volume, so updates do not affect memory, skills, or configuration.

Limitations and Tradeoffs

Self-hosting Hermes Agent is not the right choice for everyone. Consider these tradeoffs before committing to a VPS deployment.

  • You are responsible for uptime. If your VPS goes down at 3 AM, nobody restarts the agent until you do (unless you configure auto-restart and monitoring).
  • Security is your responsibility. You must keep the OS patched, configure firewalls, and secure API keys. The Hermes Agent documentation provides security recommendations, but implementation is on you.
  • Browser automation needs more resources. The Camofox anti-detection browser in v0.7.0 requires 2+ GB of additional RAM. Budget VPS plans may not handle this alongside the agent process.
  • Renewal pricing can be misleading. Hostinger and similar providers advertise low introductory rates that increase substantially upon renewal. A $4.99/month plan may renew at $11-15/month.
  • No managed backups by default. You need to set up your own backup strategy for the ~/.hermes directory. Most VPS providers offer automated snapshots for an additional $1-2/month.

For users who prefer not to manage infrastructure, managed hosting services or cloud-hosted alternatives eliminate the operational burden at a higher monthly cost.

Related Guides

Frequently Asked Questions

How much does it cost to self-host Hermes Agent?

The minimum viable self-hosted Hermes Agent setup costs around $5-7 per month for a VPS. Hetzner's CX22 starts at approximately $4 per month, and Hostinger's KVM 1 starts at $4.99 per month. You also need to budget for LLM API costs, which range from $2-15 per month depending on your model choice.

What are the minimum VPS specs for Hermes Agent?

Hermes Agent requires a minimum of 1 vCPU and 2 GB RAM for basic operation without browser tools. For browser automation and parallel sub-agents, 2 vCPUs and 4-8 GB RAM is recommended. Storage needs are minimal — 20-40 GB SSD is sufficient for the agent, Docker, and memory databases.

Can I run Hermes Agent without Docker?

Yes. Hermes Agent supports bare-metal installation via the one-line installer script: curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash. However, Docker is recommended for production deployments because it provides process isolation, easier updates, and consistent environments across providers.

Which VPS provider is best for Hermes Agent?

Hetzner offers the best price-to-performance ratio for Hermes Agent, with plans starting around $4 per month for 2 vCPUs and 4 GB RAM. Hostinger is the easiest option with one-click Docker templates and KVM plans starting at $4.99 per month. DigitalOcean is a reliable alternative starting at $6 per month but costs more for equivalent specs.

Do I need a domain name and SSL for Hermes Agent?

A domain and SSL are not strictly required if you only use Hermes Agent through messaging platforms like Telegram or Discord. However, if you want to use the web UI, API server, or webhooks, you need a domain with SSL. Let's Encrypt provides free SSL certificates, and Caddy can automate the entire process.

Top comments (0)