hermes-s6-container-supervision
CommunityMaster s6 supervision in Hermes Docker
Software Engineering#debugging#docker#container orchestration#supervision#s6-overlay#gateway reconciliation#profile services
Authorjaredcroxton
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It helps you understand and troubleshoot how Hermes uses s6-overlay to supervise per-profile gateways and static services inside the Hermes Agent Docker image, especially when services fail to start, restart correctly, or behave unexpectedly after container restarts.
Core Features & Use Cases
- Explain the CMD-as-main-program architecture: clarifies how
/opt/hermes/docker/main-wrapper.shinteracts with/initunder s6-overlay and why the container exit behavior differs from fully supervised setups. - Guide static service and gateway troubleshooting: focuses on diagnosing missing or unstable per-profile gateway services in
/run/service/and understanding the reconciliation behavior on each boot. - Provide actionable container-level workflows: includes practical inspection, manual start/stop/restart operations, and how to interpret
container-boot.logresults when reconciling profiles.
Quick Start
Use this skill to debug why a profile gateway service isn’t staying up by inspecting its s6 status in /run/service/gateway-<profile> and correlating behavior with the latest entries in /opt/data/logs/container-boot.log.
Dependency Matrix
Required Modules
None requiredComponents
Standard packageđź’» Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: hermes-s6-container-supervision Download link: https://github.com/jaredcroxton/hermes-mirror/archive/main.zip#hermes-s6-container-supervision Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.