---
title: "Deploy Hermes Agent on Pethost in one click"
description: "An AI agent you talk to in Telegram, Discord or the browser. A template for Pethost: in a minute or two the app is live on your machine, with HTTPS at its own address and nightly backups."
---

[← All templates](https://pethost.dev/templates/)

# Deploy Hermes Agent on Pethost in one click

An AI agent you talk to in Telegram, Discord or the browser

[Deploy on Pethost](https://console.pethost.dev/?template=hermes-agent)

## What happens

1. You sign in to Pethost or make an account, with a passkey, GitHub or Google.
2. No machine yet? You pick a plan, and we prepare one for you. The link waits in your browser until it is ready.
3. New project opens at the app. You fill in what it asks for and click Create project: **Admin password**, **OpenRouter API key** (optional), **Telegram bot token** (optional).
4. In a minute or two the app is live at its own address with HTTPS. Its secrets are made for it at random, and its data is in the nightly backup.
5. It is a project like any other: its compose.yaml, its .env, its logs and a terminal are in the panel, and your agent can change it, roll it back or restore it.

## First steps

Sign in as admin with the password you gave; the first start takes up to a minute. A model’s key is added under API Keys. For Telegram, message your bot and approve its code on the Pairing page.

## What it runs

The template is this compose.yaml and the variables it writes into the project’s .env. Pethost runs the file as it is written.

```
services:
  hermes:
    image: nousresearch/hermes-agent:v0.21.6
    command: ["gateway", "run"]
    restart: unless-stopped
    # The agent's browser tool runs Chromium, which needs more than Docker's 64 MB of /dev/shm.
    shm_size: 1gb
    environment:
      HERMES_DASHBOARD: "1"
      HERMES_DASHBOARD_PUBLIC_URL: ${HERMES_DASHBOARD_PUBLIC_URL}
      HERMES_DASHBOARD_BASIC_AUTH_USERNAME: admin
      HERMES_DASHBOARD_BASIC_AUTH_PASSWORD: ${HERMES_DASHBOARD_BASIC_AUTH_PASSWORD}
      HERMES_DASHBOARD_BASIC_AUTH_SECRET: ${HERMES_DASHBOARD_BASIC_AUTH_SECRET}
      OPENROUTER_API_KEY: ${OPENROUTER_API_KEY:-}
      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN:-}
    volumes:
      - data:/opt/data

volumes:
  data:
```

[compose.yaml](https://pethost.dev/templates/hermes-agent/compose.yaml)[See it on GitHub](https://github.com/pethost-dev/templates/tree/main/hermes-agent)

Pethost · Stephan Gomer · NIP 1133096755

[Templates](https://pethost.dev/templates/) [About](https://pethost.dev/about/) [Blog](https://pethost.dev/blog/) [Terms](https://pethost.dev/terms/) [Privacy](https://pethost.dev/privacy/) [Refunds](https://pethost.dev/refunds/) [API](https://pethost.dev/docs/api/) [CLI](https://pethost.dev/docs/cli/) [Plugin](https://github.com/pethost-dev/plugin) [support@pethost.dev](mailto:support@pethost.dev)