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
• Inside the claudex sandbox every docker subcommand reaches the rootless daemon, which holds none of this stack - take the route in ### Reaching the Stack from the claudex Sandbox instead

Service Categories

Available Profiles

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.

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

Reaching the Stack from the claudex Sandbox

Every service's output reaches the journal of hippocampus-compose.service.

journalctl -u hippocampus-compose.service -f
journalctl -u hippocampus-compose.service --no-pager -o cat | grep '^comfyui-1 '

Each line keeps the <service>-1 | prefix docker compose up writes, so grep selects one service the way docker compose logs <service> would.

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](reference/ai-ml.md)