Repository files navigation

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.

NoteThe 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).

Icon indicates Sample is compatible withDocker+Wasm.

• ASP.NET / MS-SQL - Sample ASP.NET core applicationwith MS SQL server database.
• Elasticsearch / Logstash / Kibana - Sample Elasticsearch, Logstash, and Kibana stack.
• Go / NGINX / MySQL - Sample Go applicationwith an Nginx proxy and a MySQL database.
• Go / NGINX / PostgreSQL - Sample Goapplication with an Nginx proxy and a PostgreSQL database.
• Java Spark / MySQL - Sample Java application anda MySQL database.
• NGINX / ASP.NET / MySQL - Sample Nginx reverse proxy with an C# backend using ASP.NET.
• NGINX / Flask / MongoDB - Sample Python/Flaskapplication with Nginx proxy and a Mongo database.
• 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.
• 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.
• React / Spring / MySQL - Sample Reactapplication with a Spring backend and a MySQL database.
• React / Express / MySQL - Sample Reactapplication with a Node.js backend and a MySQL database.
• React / Express / MongoDB - Sample Reactapplication with a Node.js backend and a Mongo database.
• React / Rust / PostgreSQL - Sample Reactapplication with a Rust backend and a Postgres database.
• React / Nginx - Sample React application with Nginx.
• Spring / PostgreSQL - Sample Java applicationwith Spring framework and a Postgres database.
• 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. 
• 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. 

• Angular
• Spark
• VueJS
• Flask
• PHP
• Traefik
• Django
• Minecraft server
• Plex
• Portainer
• Wireguard
• FastAPI

• 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 anddeploying 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 thenDocker Compose
• Download some or all of the samples from this repository.

The root directory of each sample contains thecompose.yaml whichdescribes the configuration of service components. All samples can be run ina local environment by going into the root directory of each one and executing:

docker compose up -d

Check theREADME.md of each sample to get more details on the structure andwhat 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 folderofficial-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 forcommon applications. Check theContribution Guide for more details.