Hermes-WebUI

Overview

Hermes Agent is a sophisticated autonomous agent that lives on your server, accessed via a terminal or messaging apps, that remembers what it learns and gets more capable the longer it runs. Hermes WebUI is a lightweight web app interface in your browser for Hermes Agent. Full parity with the CLI experience - everything you can do from a terminal, you can do from this UI. Please see https://github.com/mmartial/Unraid-templates/ for deployment notes. Layout: three-panel. Left sidebar for sessions and navigation, center for chat, right for workspace file browsing. Model, profile, and workspace controls live in the composer footer — always visible while composing. A circular context ring shows token usage at a glance. All settings and session tools are in the Hermes Control Center (launcher at the sidebar bottom). This template uses the official Hermes WebUI docker image, and it is configured to run using specified WANTED_UID and WANTED_GID environment variables If a new variable is added to the official image and you want it added to the template, please let me know. If you encounter issues with this template (not the underlying application), please open an issue in the template repository, not in the Hermes WebUI repository, as it is not maintained by the same team.

Requirements

An already running "Hermes Agent" from the same maintainer. Do not start the WebUI without it. If you update the main agent container or update hermes, you will need to restart the WebUI container.

Runtime arguments

Web UI: http://[IP]:[PORT:8787]
Network: docker
Shell: bash
Privileged: false

Template configuration

WebUI PortPorttcp

Target: 8787
Default: 8787
Value: 8787

HERMES_WEBUI_HOSTVariable

Host to use for WebUI

Default: 0.0.0.0
Value: 0.0.0.0

HERMES_WEBUI_PORTVariabletcp

Port to use for WebUI within the container. Do not modify

Default: 8787
Value: 8787

WANTED_UIDVariable

UID to use for content

Default: 99
Value: 99

WANTED_GIDVariable

GID to use for content

Default: 100
Value: 100

HERMES_HOMEVariable

Home directory for Hermes data (WebUI expects a slightly different location)

Default: /home/hermeswebui/.hermes
Value: /home/hermeswebui/.hermes

HERMES_HOME Unraid locationPathrw

Location where the container stores all user data (config, API keys, sessions, skills, memories)

Target: /home/hermeswebui/.hermes
Default: /mnt/user/appdata/hermes-agent/hermes-home
Value: /mnt/user/appdata/hermes-agent/hermes-home

HERMES_WORKSPACEVariable

Workspace directory for Hermes data

Default: /home/hermeswebui/workspace
Value: /home/hermeswebui/workspace

HERMES_WORKSPACE Unraid locationPathrw

Location of Hermes workspace. Multiple workspaces can be created; duplicate this entry for each workspace and give it a new name

Target: /home/hermeswebui/workspace
Default: /mnt/user/appdata/hermes-agent/workspace
Value: /mnt/user/appdata/hermes-agent/workspace

HERMES_WEBUI_STATE_DIRVariable

Directory to use for WebUI state. Will be created within the already mountedHermes data folder

Default: /home/hermeswebui/.hermes/webui
Value: /home/hermeswebui/.hermes/webui

HERMES_WEBUI_PASSWORDVariable

Password for WebUI access (delete to disable) (default: hermes)

Default: hermes
Value: hermes

Hermes Shared Source VolumePathrw

A Docker named volume (do not change: using a folder path will not work) that auto-populates from the image (target must be the same for all hermes templates)

Target: /home/hermeswebui/.hermes/hermes-agent
Default: hermes_shared_volume
Value: hermes_shared_volume

Links

Template Support GHCR Project

Details

Repository

ghcr.io/nesquena/hermes-webui:latest

Registry

https://ghcr.io/nesquena/hermes-webui/

Last Updated2026-06-01

First Seen2026-04-25

Run Hermes-WebUI on Unraid.

Hermes-WebUI is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS