Repository navigation
v1.0.0 — Initial public release
First public release of the Docker Compose Field Guide.
What's included
- Annotated template —
docker-compose.ymlwith security defaults, resource limits, healthchecks, and inline explanations - Best practices guide — 21 sections covering image pinning, secrets, networking, capabilities, monitoring, and more
- Troubleshooting playbook — step-by-step debugging workflow with decision tree
- Hardened recipes — Pi-hole, Nextcloud (+MariaDB +Redis), Traefik v3 with HTTPS
- Quickstart stack — Homepage dashboard + Uptime Kuma monitoring (working demo)
- MCP server — 11 tools for AI coding agents (Claude Code, VS Code, Cursor)
- Monitoring stack — Prometheus + Grafana + Node Exporter + cAdvisor
- Helper scripts — safe reset, hard reset, disk report, prune
- Reverse proxy guide — Traefik architecture, certificate methods, multi-stack networking
- Secrets management guide — SOPS + age, Doppler, git-crypt
- AI agent instructions — CLAUDE.md, AGENTS.md, copilot-instructions.md
- CI pipeline — YAML lint, Markdown lint, ShellCheck, compose validation, live stack test, link check