Docker Compose Cheat Sheet

Core Philosophy

1. Optimize for local workflows — Compose is most valuable when it shortens the path to a working multi-service environment.
2. Keep service definitions readable — A cheat sheet should surface the fields engineers reach for most often.
3. Separate lifecycle commands from YAML syntax — Operators and authors need both, but not mixed chaotically.
4. Prefer explicit dependencies and healthchecks — Most Compose confusion comes from startup timing and hidden environment coupling.
5. Profiles and overrides are leverage — They keep one Compose setup usable across dev, test, and optional services.

Quick-Start: Common Problems

"How do I start or rebuild everything?"

1. docker compose up -d
2. docker compose up --build
3. docker compose down -> See references/commands-and-yaml.md