docker-compose-operations

• 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

# 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

# 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