Agent skill

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.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/docker-compose-operations

Metadata

Additional technical details for this skill

short description
docker-compose, compose, container, local-dev, ollama, comfyui, stable-diffusion, mcp-server, container-logs, envoy-local, コンテナ, ローカル環境

SKILL.md

  • 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

Category Services Access
AI/ML (profile) comfyui, stable-diffusion-*, llama.cpp, yue Profile-based
AI/ML (always-on) ollama, open-webui Always-on
Observability grafana, prometheus, jaeger, pyroscope Always-on
Datastores mysql, redis, minio, qdrant, cassandra, influxdb Always-on
Gateway envoy, mitmproxy Always-on
MCP Servers github-mcp-server, playwright-mcp, chrome-devtools-mcp, mcp-filesystem Always-on

Available Profiles

Profile Description GPU
stable-diffusion-webui Original Stable Diffusion WebUI Yes
stable-diffusion-webui-forge Improved Stable Diffusion WebUI Yes
comfyui Node-based AI image generation Yes
llama.cpp LLaMA.cpp for LLM inference Yes
yue Yue server Yes

Common Commands

bash
# 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.

Service URL Note
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
Symptom Action
Service not starting Check logs, verify dependencies, check volumes
Connection refused Verify network, check service health
GPU not available Check nvidia-smi, verify runtime configuration
Model download failed Check HF_HUB_TOKEN, verify network access

Volume Management

bash
# 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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results