---
title: "Deploy hermes-all-in-one"
description: "Hermes Agent with WebUI and Control Plane"
category: "AI/ML"
url: https://railway.com/deploy/hermes-all-in-one
---

# Deploy hermes-all-in-one

Hermes Agent with WebUI and Control Plane

**[Deploy hermes-all-in-one on Railway](https://railway.com/template/hermes-all-in-one)**

- **Creator:** Softnetics
- **Category:** AI/ML
- **Total deploys:** 22

## Template content

### hermes-all-in-one

- **Source:** saenyakorn/hermes-all-in-one
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# Deploy and Host hermes-all-in-one on Railway

**hermes-all-in-one** packages [Hermes Agent](https://github.com/NousResearch/hermes-agent) and [Hermes WebUI](https://github.com/nesquena/hermes-webui) into one Docker image: a browser chat UI at `/`, an admin control plane at `/admin` for providers and channels (no terminal required), and optional gateway autostart so Telegram, Discord, Slack, and the WebUI share one Hermes identity, config, and data directory.

## About Hosting hermes-all-in-one

Hosting means running a single Railway service built from this repo’s `Dockerfile`. The build is multi-stage: it copies Hermes Agent and WebUI source from their official container images, installs Python dependencies with **uv**, then starts **`/app/start.sh`**, which launches the control plane. The public service exposes the control plane (including a reverse proxy to the internal WebUI). You should attach a **persistent volume mounted at `/data`** so `HERMES_HOME`, WebUI state, workspace, and credentials survive redeploys. Set strong passwords (`HERMES_ADMIN_PASSWORD`, `HERMES_WEBUI_PASSWORD`) and complete first-time setup at **`/admin`** (providers, optional channels) before relying on the chat UI at `/`. Health checks use **`GET /health`**.

## Common Use Cases

- **Personal AI assistant** — Chat in the browser with memory and tools, without running Hermes on your laptop.
- **Messaging + browser in one** — Connect Telegram, Discord, or Slack from `/admin` and use the same agent and memory as the WebUI.
- **Low-ops team demo** — Share one deployed instance with a small group using env-based auth and the admin panel for keys and gateway controls.

## Dependencies for hermes-all-in-one Hosting

- **Persistent disk** — Railway volume (or equivalent) mounted at **`/data`** for long-lived Hermes and WebUI state.
- **Container registry access at build time** — The Docker build pulls **`nousresearch/hermes-agent`** and **`ghcr.io/nesquena/hermes-webui`** (see `Dockerfile`); the build environment must reach those registries.

### Deployment Dependencies

- [Deploy on Railway (template)](https://railway.com/deploy/hermes-all-in-one-or-webui-admin-panel-g?referralCode=1uw5HI)
- [Hermes Agent (NousResearch)](https://github.com/NousResearch/hermes-agent)
- [Hermes WebUI](https://github.com/nesquena/hermes-webui)
- [Railway documentation](https://docs.railway.com/)

### Implementation Details

Railway reads [`railway.toml`](railway.toml) for the Docker build, start command, and health check:

```toml
[build]
builder = "DOCKERFILE"
dockerfilePath = "Dockerfile"

[deploy]
startCommand = "/app/start.sh"
healthcheckPath = "/health"
restartPolicyType = "ON_FAILURE"
restartPolicyMaxRetries = 10
```

To pin upstream versions, pass Docker build arguments **`HERMES_AGENT_VERSION`** and **`HERMES_WEBUI_VERSION`** (image tags used in the `FROM … AS hermes_*_src` stages). See [`.env.example`](.env.example) for runtime variables such as `HERMES_HOME`, `HERMES_WEBUI_PASSWORD`, and `HERMES_GATEWAY_AUTOSTART`.

## Why Deploy hermes-all-in-one on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying hermes-all-in-one on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/hermes-all-in-one