- 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
- Check service status:
docker compose ps
- View logs:
docker compose logs -f <service>
- Check health:
docker compose exec <service> healthcheck-command
- 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
1---
2# Generated by sync-agent-files.sh. DO NOT EDIT.
3name: docker-compose-operations
4description: 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.
5metadata:
6 short-description: docker-compose, compose, container, local-dev, ollama, comfyui, stable-diffusion, mcp-server, container-logs, envoy-local, コンテナ, ローカル環境
7---
8
9* Access services via `*.127.0.0.1.nip.io` domains through Envoy gateway
10* GPU services require `runtime: nvidia` (NVIDIA Docker runtime)
11* Use `docker compose logs -f <service>` for real-time log monitoring
12
13### Service Categories
14
15| Category | Services | Access |
16|----------|----------|--------|
17| AI/ML (profile) | comfyui, stable-diffusion-*, llama.cpp, yue | Profile-based |
18| AI/ML (always-on) | ollama, open-webui | Always-on |
19| Observability | grafana, prometheus, jaeger, pyroscope | Always-on |
20| Datastores | mysql, redis, minio, qdrant, cassandra, influxdb | Always-on |
21| Gateway | envoy, mitmproxy | Always-on |
22| MCP Servers | github-mcp-server, playwright-mcp, chrome-devtools-mcp, mcp-filesystem | Always-on |
23
24### Available Profiles
25
26| Profile | Description | GPU |
27|---------|-------------|-----|
28| stable-diffusion-webui | Original Stable Diffusion WebUI | Yes |
29| stable-diffusion-webui-forge | Improved Stable Diffusion WebUI | Yes |
30| comfyui | Node-based AI image generation | Yes |
31| llama.cpp | LLaMA.cpp for LLM inference | Yes |
32| yue | Yue server | Yes |
33
34### Common Commands
35
36```bash
37# Start profile-based services
38docker compose --profile=comfyui up -d
39
40# View logs
41docker compose logs -f grafana
42
43# Execute commands in container
44docker compose exec redis redis-cli
45docker compose exec mysql mysql -u hippocampus -p
46
47# Check GPU status
48docker compose exec dcgm-exporter nvidia-smi
49
50# Restart service
51docker compose restart prometheus
52```
53
54### Web Interfaces
55
56Services are accessible via `http://{service}.127.0.0.1.nip.io`. See `docker-compose/envoy/envoy.yaml` for available domains.
57
58| Service | URL | Note |
59|---------|-----|------|
60| Envoy Admin | `http://localhost:9901` | Direct access |
61| mitmproxy Web | `http://localhost:18081` | Direct access |
62
63### Debugging Workflow
64
651. **Check service status**: `docker compose ps`
662. **View logs**: `docker compose logs -f <service>`
673. **Check health**: `docker compose exec <service> healthcheck-command`
684. **Inspect network**: `docker compose exec envoy curl -s http://<service>:<port>/health`
69
70| Symptom | Action |
71|---------|--------|
72| Service not starting | Check logs, verify dependencies, check volumes |
73| Connection refused | Verify network, check service health |
74| GPU not available | Check `nvidia-smi`, verify runtime configuration |
75| Model download failed | Check `HF_HUB_TOKEN`, verify network access |
76
77### Volume Management
78
79```bash
80# List volumes
81docker volume ls | grep hippocampus
82
83# Inspect volume
84docker volume inspect hippocampus_comfyui-models
85
86# Access volume data via ephemeral-container
87docker compose exec ephemeral-container ls /home/nonroot/ComfyUI/models
88```
89
90### Reference
91
92If managing AI/ML services:
93 See [AI/ML Services](reference/ai-ml.md)
majiayu000