Awesome Compose: Your Go-To Collection of Docker Compose Samples for Local Dev

If you've ever wasted an afternoon trying to piece together a docker-compose.yml for a local dev stack (Postgres + Redis + a queue, maybe some Elasticsearch), you know the pain. Every project needs something slightly different, and while the Docker docs are great, they don't always give you a ready-to-run sample for that specific combo.

That's exactly why awesome-compose exists. It's a curated GitHub repo that collects real-world Docker Compose samples for local development, so you don't have to reinvent the wheel each time.

What It Does

The repo, docker/awesome-compose, is exactly what it sounds like: a bunch of docker-compose.yml files, each set up to run a specific local dev stack. Think of it as a cookbook for Docker Compose.

You get samples for:

• Databases (PostgreSQL, MySQL, MongoDB, Couchbase, etc.)
• Message queues (RabbitMQ, Redis with Sidekiq, Kafka)
• Web servers (Nginx, Apache, Traefik)
• Language runtimes (Node.js, Python, Ruby, Go, Java, .NET)
• Full stacks (LAMP, MEAN, Django + PostgreSQL, Spring Boot + MySQL, you name it)

Each sample is a self-contained folder with a docker-compose.yml, sometimes a minimal Dockerfile, and a README explaining what it does and how to run it. No fluff, no extra dependencies, just a docker compose up away from a working environment.

Why It's Cool

1. It's beginner-friendly but also a time-saver for pros
If you're new to Docker Compose, you can pick any sample, run it, and immediately see how a service like "Redis + a worker" actually behaves. If you're experienced, it's a cheat sheet for common patterns you'd otherwise write from scratch.

2. It's actively curated by Docker
This isn't some random blog post from 2019 that's already broken. Docker themselves maintain the repo, so samples stay updated with the latest image tags, best practices, and security defaults.

3. Real-world combos, not just basic web servers
You'll find stacks like:

• nginx-flask-mongo (web + API + NoSQL)
• traefik-certificate (reverse proxy with TLS)
• nodejs-express-elasticsearch-kibana (search stack)
• ruby-postgres-redis (Rails-like setup)

No over-engineered "hello world" here.

4. Multi-service patterns are clear
Each sample shows not just the services, but also how they connect (networks, volumes, environment variables). You can literally copy-paste the pattern for your own project.

How to Try It

1. Clone the repo:

   git clone https://github.com/docker/awesome-compose.git
   cd awesome-compose
   

2. Pick a stack you want to try. For example, a simple Redis-backed Node.js app:

   cd nodejs-express-redis
   

3. Read the README.md (it's usually short), then run:

   docker compose up
   

4. Visit http://localhost:3000 and you'll have a working app with Redis caching.

That's it. No config, no environment setup. Just a running stack ready for you to poke at.

Final Thoughts

This is one of those repos you bookmark and forget about until you need it, and then you're genuinely grateful it exists. It's not flashy. It's not trying to replace anything. It's just a well-organized collection of working Compose files that solve a very common, slightly annoying problem.

If you're a dev who uses Docker Compose at all (or wants to start), spend 5 minutes browsing the repo. Chances are, you'll find a stack that matches your next project — and save yourself a good 30 minutes of "why isn't this connecting" debugging.

Found this helpful? Follow @githubprojects for more dev-friendly project highlights.