Deploy Hermes Agent
Deploy Hermes Agent: an open-source AI agent with dashboard and memory.
hermes-agent
Just deployed
/data
Deploy and Host Hermes Agent with Railway
Hermes Agent is an open-source AI agent from Nous Research that runs as a persistent service: a browser dashboard, long-term memory, skills, scheduled tasks, and messaging channels you can talk to from Telegram, Discord, Slack or WhatsApp. This template runs the official nousresearch/hermes-agent image with a volume attached, so the agent keeps its state across redeploys.
About Hosting Hermes Agent
This template provisions a single Railway service from the official image, with s6 supervising the gateway so the agent restarts itself if a channel, tool or cron job crashes. A Railway volume is mounted at /data; Hermes stores everything it knows under /data/.hermes — config, sessions, memory, skills, profiles and channel credentials.
The dashboard is served on port 8080 behind a username and password, and the service exposes a healthcheck at /api/status. The image itself is stateless, so upgrading Hermes never touches your data.
Why Deploy Hermes Agent
- One click, no CLI. The image, entrypoint, volume mount, port, healthcheck and restart policy are already configured.
- State that survives redeploys. Memory, sessions and channel credentials live on the volume, not in variables.
- A dashboard, not a container you SSH into. Configure models, channels, skills and cron jobs from the browser.
- Self-hosted and portable. Your data stays in your Railway project; the agent runs on open-source software you can move anywhere.
- Upgrade on your schedule. The Dockerfile pins a release by tag and digest; bump it and redeploy.
Common Use Cases
- A personal assistant reachable from Telegram or WhatsApp that remembers context across conversations.
- Scheduled automations: morning briefings, inbox triage, monitoring and reports.
- A research or knowledge-base agent with persistent memory over your own material.
- A self-hosted agent sandbox for testing models, skills and tool integrations.
Dependencies for Hermes Agent
- A model provider: a Nous Portal account, or an API key for OpenRouter, Anthropic, OpenAI or any OpenAI-compatible endpoint. Configure it in the dashboard after the first boot.
- Optional: a bot token for whichever messaging channel you want to connect.
- Railway resources: the default volume (5 GB) plus roughly 1 GB of RAM is a sensible starting point.
Deployment Dependencies
| Variable | Required | Description |
|---|---|---|
ADMIN_USERNAME | Yes | Username for the dashboard login. admin is a fine default. |
ADMIN_PASSWORD | Yes | Password for the dashboard login. Choose something strong — this is the only thing protecting a publicly reachable dashboard. |
| Setting | Value |
|---|---|
| Volume mount | /data |
| Public port | 8080 |
| Healthcheck path | /api/status |
| Start command | /usr/local/bin/hermes-railway-entrypoint gateway run |
No model or messaging keys are needed to deploy — add them from the dashboard after the first boot.
After deploying
- Open the generated Railway domain and sign in with the credentials you supplied.
- Connect a model provider in the dashboard. Nothing works until a model is configured.
- Optionally connect a messaging channel and paste its bot token.
- Anything you configure from the dashboard is written to the volume, so it survives the next redeploy and never appears in this template.
Do not detach or delete the volume: it holds the agent's entire memory and state.
Upgrading
This template builds from andreataglia/hermes-agent-railway-template, which pins a Hermes release by tag and digest in its Dockerfile. Bump that pin and redeploy to upgrade. Redeploying pulls the latest commit on main, so existing deployments can move to a newer release without recreating the template.
Resources
Support
Issues with the agent or the image belong upstream in NousResearch/hermes-agent. Issues with this Railway template (image pin, entrypoint, Railway settings) go to andreataglia/hermes-agent-railway-template.
Template Content
hermes-agent
andreataglia/hermes-agent-railway-templateADMIN_PASSWORD
ADMIN_USERNAME

