logo

A curated list of Docker Compose samples.

These samples provide a starting point for how to integrate different services using a Compose file and to manage their deployment with Docker Compose.

Note The following samples are intended for use in local development environments such as project setups, tinkering with software stacks, etc. These samples must not be deployed in production environments.

• Samples of Docker Compose applications with multiple integrated services.
• Single service samples.
• Basic setups for different platforms (not production ready - useful for personal use).

Use with Docker Dev Environments Icon indicates Sample is compatible with Docker Dev Environments in Docker Desktop version 4.10 or later.

Docker + wasm Icon indicates Sample is compatible with Docker+Wasm.

• ASP.NET / MS-SQL - Sample ASP.NET core application with MS SQL server database.
• Elasticsearch / Logstash / Kibana - Sample Elasticsearch, Logstash, and Kibana stack.
• Go / NGINX / MySQL - Sample Go application with an Nginx proxy and a MySQL database. Use with Docker Dev Environments
• Go / NGINX / PostgreSQL - Sample Go application with an Nginx proxy and a PostgreSQL database. Use with Docker Dev Environments
• Java Spark / MySQL - Sample Java application and a MySQL database. Use with Docker Dev Environments
• NGINX / ASP.NET / MySQL - Sample Nginx reverse proxy with an C# backend using ASP.NET Use with Docker Dev Environments
• NGINX / Flask / MongoDB - Sample Python/Flask application with Nginx proxy and a Mongo database. Use with Docker Dev Environments
• NGINX / Flask / MySQL - Sample Python/Flask application with an Nginx proxy and a MySQL database.
• NGINX / Node.js / Redis - Sample Node.js application with Nginx proxy and a Redis database
• NGINX / Go - Sample Nginx proxy with a Go backend. Use with Docker Dev Environments
• NGINX / WSGI / Flask - Sample Nginx reverse proxy with a Flask backend using WSGI.
• PostgreSQL / pgAdmin - Sample setup for postgreSQL database with pgAdmin web interface
• Python / Flask / Redis - Sample Python/Flask and a Redis database Use with Docker Dev Environments
• React / Spring / MySQL - Sample React application with a Spring backend and a MySQL database. Use with Docker Dev Environments
• React / Express / MySQL - Sample React application with a Node.js backend and a MySQL database. Use with Docker Dev Environments
• React / Express / MongoDB - Sample React application with a Node.js backend and a Mongo database. Use with Docker Dev Environments
• React / Rust / PostgreSQL - Sample React application with a Rust backend and a Postgres database. Use with Docker Dev Environments
• React / Nginx - Sample React application with Nginx. Use with Docker Dev Environments
• Spring / PostgreSQL - Sample Java application with Spring framework and a Postgres database. Use with Docker Dev Environments
• WasmEdge / MySQL / Nginx - Sample Wasm-based web application with a static HTML frontend, using a MySQL (MariaDB) database. The frontend connects to a Wasm microservice written in Rust, that runs using the WasmEdge runtime. Compatible with Docker+wasm
• WasmEdge / Kafka / MySQL - Sample Wasm-based microservice that subscribes to a Kafka (Redpanda) queue topic, and transforms and saves any incoming message into a MySQL (MariaDB) database. Compatible with Docker+wasm

Use with Docker Dev Environments Icon indicates Sample is compatible with Docker Dev Environments in Docker Desktop version 4.10 or later.

• Angular Use with Docker Dev Environments
• Spark Use with Docker Dev Environments
• VueJS Use with Docker Dev Environments
• Flask Use with Docker Dev Environments
• PHP Use with Docker Dev Environments
• Traefik Use with Docker Dev Environments
• Django Use with Docker Dev Environments
• Minecraft server
• Plex
• Portainer
• Wireguard
• FastAPI Use with Docker Dev Environments

• Gitea / PostgreSQL
• Nextcloud / PostgreSQL
• Nextcloud / Redis / MariaDB
• Pi-hole / cloudflared - Sample Pi-hole setup with use of DoH cloudflared service
• Prometheus / Grafana
• Wordpress / MySQL

These instructions will get you through the bootstrap phase of creating and deploying samples of containerized applications with Docker Compose.

• Make sure that you have Docker and Docker Compose installed
  • Windows or macOS: Install Docker Desktop
  • Linux: Install Docker and then Docker Compose
• Download some or all of the samples from this repository.

The root directory of each sample contains the compose.yaml which describes the configuration of service components. All samples can be run in a local environment by going into the root directory of each one and executing:

docker compose up -d

Check the README.md of each sample to get more details on the structure and what is the expected output. To stop and remove all containers of the sample application run:

docker compose down

In addition to all the ready to run Compose samples listed above the folder official-documentation-samples contains quickstart guides. Each of these step by step guides explain which files need to be created to build and run a Docker Compose application.

We welcome examples that help people understand how to use Docker Compose for common applications. Check the Contribution Guide for more details.