메뉴
Use when working with Hermes Agent on umbrelOS, including persistence, paths, container behavior, app updates, gateway/dashboard troubleshooting, networking, ports, or installing tools inside the app sandbox.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | umbrel |
| description | Use when working with Hermes Agent on umbrelOS, including persistence, paths, container behavior, app updates, gateway/dashboard troubleshooting, networking, ports, or installing tools inside the app sandbox. |
| version | 1.0.0 |
Hermes is running as an Umbrel app inside a containerized sandbox, not as a normal host Linux install. Use this skill whenever a task touches persistence, paths, installation, networking, app updates, dashboard behavior, gateway behavior, or container lifecycle.
/opt/data is the persistent Hermes home for this Umbrel app. Put durable user files, generated artifacts, scripts, and agent-owned state there unless the user asks for another location.
Files outside /opt/data are not durable and should be treated as disposable across app updates.
When giving the user terminal commands to run themselves, explain the umbrelOS path first: Settings -> Advanced Settings -> Terminal -> App -> Hermes Agent.
When asking the user to edit files, explain the umbrelOS Files path first: Files -> Apps -> Hermes Agent -> data -> hermes.
When asking the user to restart the Hermes Agent app, prefer the umbrelOS homescreen path. On desktop, right-click the Hermes Agent app icon and choose Restart. On mobile or touch devices, press and hold the Hermes Agent app icon, then choose Restart.
The Umbrel app uses one container with upstream s6 supervision:
Interactive chats from the dashboard chat tab and messaging-platform chats such as Telegram run inside the same app container, sharing /opt/data.
The dashboard Chat tab starts with an Umbrel launch shim. If no usable model provider is configured, the shim runs hermes setup before handing off to the official Hermes TUI.
The dashboard is behind Umbrel's authenticated app proxy. Services started inside the container are not automatically reachable from umbrelOS or the public network; that exposure is controlled by the Umbrel app packaging/proxy.
Do not run hermes update or install a different Hermes version from inside the app. Umbrel updates Hermes by shipping pinned Docker images through app updates.
If Hermes reports that an update is available, explain that updates are managed by umbrelOS.
/opt/data./tmp, /app, default home directories, or system package state for anything that should survive an app update.The container may not behave like a full host OS. Prefer user-space installs under /opt/data where practical.
When installing tools:
/opt/data./opt/data when possible./opt/data and may be lost on app update.localhost is container-local; it reaches services in the Hermes app container, but not services in other Umbrel app containers.