Claude-skill-registry docker-compose-operations

Operations for local container stacks defined in docker-compose.yaml or docker-compose/ directory. Handles AI/ML services (Ollama, ComfyUI), standalone databases, and local observability stacks. Use for 'docker compose' commands, checking container logs, or restarting specific local services. For cluster Grafana/Prometheus (via kubectl or cluster/manifests/), use kubernetes-operations instead.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/docker-compose-operations" ~/.claude/skills/majiayu000-claude-skill-registry-docker-compose-operations && rm -rf "$T"
manifest: skills/data/docker-compose-operations/SKILL.md
source content
  • Access services via
    *.127.0.0.1.nip.io
    domains through Envoy gateway
  • GPU services require
    runtime: nvidia
    (NVIDIA Docker runtime)
  • Use
    docker compose logs -f <service>
    for real-time log monitoring

Service Categories

CategoryServicesAccess
AI/ML (profile)comfyui, stable-diffusion-*, llama.cpp, yueProfile-based
AI/ML (always-on)ollama, open-webuiAlways-on
Observabilitygrafana, prometheus, jaeger, pyroscopeAlways-on
Datastoresmysql, redis, minio, qdrant, cassandra, influxdbAlways-on
Gatewayenvoy, mitmproxyAlways-on
MCP Serversgithub-mcp-server, playwright-mcp, chrome-devtools-mcp, mcp-filesystemAlways-on

Available Profiles

ProfileDescriptionGPU
stable-diffusion-webuiOriginal Stable Diffusion WebUIYes
stable-diffusion-webui-forgeImproved Stable Diffusion WebUIYes
comfyuiNode-based AI image generationYes
llama.cppLLaMA.cpp for LLM inferenceYes
yueYue serverYes

Common Commands

# Start profile-based services
docker compose --profile=comfyui up -d

# View logs
docker compose logs -f grafana

# Execute commands in container
docker compose exec redis redis-cli
docker compose exec mysql mysql -u hippocampus -p

# Check GPU status
docker compose exec dcgm-exporter nvidia-smi

# Restart service
docker compose restart prometheus

Web Interfaces

Services are accessible via

http://{service}.127.0.0.1.nip.io
. See
docker-compose/envoy/envoy.yaml
for available domains.

ServiceURLNote
Envoy Admin
http://localhost:9901
Direct access
mitmproxy Web
http://localhost:18081
Direct access

Debugging Workflow

  1. Check service status:
    docker compose ps
  2. View logs:
    docker compose logs -f <service>
  3. Check health:
    docker compose exec <service> healthcheck-command
  4. Inspect network:
    docker compose exec envoy curl -s http://<service>:<port>/health
SymptomAction
Service not startingCheck logs, verify dependencies, check volumes
Connection refusedVerify network, check service health
GPU not availableCheck
nvidia-smi
, verify runtime configuration
Model download failedCheck
HF_HUB_TOKEN
, verify network access

Volume Management

# List volumes
docker volume ls | grep hippocampus

# Inspect volume
docker volume inspect hippocampus_comfyui-models

# Access volume data via ephemeral-container
docker compose exec ephemeral-container ls /home/nonroot/ComfyUI/models

Reference

If managing AI/ML services: See AI/ML Services