Hermes Agent

Self-hosted AI agent with web terminal and messaging gateway.

ai agent terminal self-hosted docker tools llm automation

Ports

Deps

Use Cases

Official Website View on GitHub View compose.yml

About

What Hermes Agent does

Hermes Agent is a self-hosted AI agent platform combining a web terminal dashboard with an underlying messaging gateway. It provides a browser-accessible terminal interface backed by the Hermes gateway service, enabling you to run and interact with AI agents entirely on your own infrastructure.

Install Flow

How to self-host Hermes Agent

Hermes Agent can be deployed with standard Docker Compose using the Yantr app catalog. This page collects the basic information searchers usually need first: what Hermes Agent does, which Docker image Yantr uses, default ports, dependencies, and where to find the original compose template.

If you searched for Hermes Agent Docker, Hermes Agent Docker Compose, or self-host Hermes Agent, this page is the direct landing page for that app in Yantr's catalog.

After deployment, Yantr also lets you publish additional ports later from the stack page using Docker-style syntax. Use mappings like 8080:8080 for a fixed host port or just 8080 to let Docker assign a random host port for container port 8080.

Use Cases

What people run it for

Access a browser-based terminal to interact with AI agents running on your own server without relying on third-party cloud services.

Run the Hermes messaging gateway locally to orchestrate AI agent tasks and automate workflows with full control over your data.

Use the health-check API to monitor gateway status from the web dashboard and ensure agent services are always running.

Technical Details

Ports, image, and service metadata

Ports

These are the standard container ports Yantr knows about for Hermes Agent. You can keep the default mapping, remap them, or publish extra ports later after deployment with Docker syntax such as 3000:3000 or 3000.

Port	Protocol	Label
18789	HTTP	Web UI

Docker Image

ghcr.io/getumbrel/hermes-agent-umbrel:v2026.4.13

Service Name

web

Notes

Things to know before you deploy

! Set HERMES_API_KEY to a strong secret before exposing the gateway — both the web and gateway services must share the same value.

! The gateway API server binds to 0.0.0.0 inside the container; it is not exposed to the host but is reachable by the web service on the internal Docker network.

Related Apps