docker/awesome-compose

Awesome Compose is a curated collection of ready-to-use Docker Compose configuration files, essentially a library of pre-written recipes for spinning up common application stacks on your local computer. Docker Compose is a tool that lets you define and run multi-container applications: rather than manually starting a database, a web server, and an application separately, you write a single YAML file (compose.yaml) that describes all of them and their connections, then start everything with one command. The problem this repository solves is the blank-page problem when setting up a local development environment. Instead of spending an afternoon figuring out how to correctly wire a Flask backend to a MySQL database behind an Nginx reverse proxy, getting environment variables, port mappings, and network names right, you can copy an existing working example and adapt it. The collection covers dozens of popular combinations: React with Express and MongoDB, Python Flask with Redis, Spring Java with PostgreSQL, Go with Nginx and MySQL, Elasticsearch with Logstash and Kibana, and many more. There are also single-service setups for individual tools like Grafana, Nextcloud, Pi-hole, Prometheus, and WordPress. You would use this repository when starting a new project and wanting a working local stack quickly, or when learning how a particular technology (such as a database or message queue) integrates with Docker. All examples are intended for local development and learning only, the README explicitly notes they are not production-ready. The only prerequisite is having Docker and Docker Compose installed. Each sample folder contains its own compose.yaml and a README explaining the expected output. No specific programming language is required to use them.