Awesome Docker Compose samples

Go to file

Mark 4b0c67e2aa docs: update docs of README.mds. summary: update command docker compose to docker-compose.		2023-01-05 22:29:01 +08:00
.github	Remove temporarily the 'java' codeql analysis (#189 )	2021-12-09 12:16:47 +01:00
angular	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
apache-php	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
aspnet-mssql	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
django	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
elasticsearch-logstash-kibana	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
fastapi	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
flask	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
flask-redis	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
gitea-postgres	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
minecraft	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nextcloud-postgres	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nextcloud-redis-mariadb	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-aspnet-mysql	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-flask-mongo	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-flask-mysql	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-golang	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-golang-mysql	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-golang-postgres	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-nodejs-redis	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
nginx-wsgi-flask	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
official-documentation-samples	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
pihole-cloudflared-DoH	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
plex	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
portainer	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
postgresql-pgadmin	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
prometheus-grafana	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
react-express-mongodb	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
react-express-mysql	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
react-java-mysql	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
react-nginx	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
react-rust-postgres	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
sparkjava	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
sparkjava-mysql	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
spring-postgres	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
traefik-golang	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
vuejs	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
wireguard	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00
wordpress-mysql	bug fixed: correct the docker-compose command.	2023-01-05 21:54:19 +08:00
.gitattributes	repo init	2020-02-12 18:16:42 +01:00
awesome-compose.jpg	repo init	2020-02-12 18:16:42 +01:00
CONTRIBUTING.md	the	2020-07-27 22:14:01 -05:00
icon_devenvs.svg	identify samples usable with Docker Dev Environments (#279 )	2022-08-09 10:30:30 +02:00
LICENSE	Update License to CC0	2020-03-26 09:44:12 +01:00
MAINTAINERS	Compliance to awesome repository requirements	2020-03-27 11:38:54 +01:00
open_in_new.svg	Add "Open in Docker Dev Environments" links (#280 )	2022-09-01 11:39:33 -05:00
README.md	docs: update docs of README.mds.	2023-01-05 22:29:01 +08:00

README.md

Awesome Compose

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

Samples of Docker Compose applications with multiple integrated services

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

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.
Go / NGINX / PostgreSQL - Sample Go application with an Nginx proxy and a PostgreSQL database.
Java Spark / MySQL - Sample Java application and a MySQL database.
NGINX / ASP.NET / MySQL - Sample Nginx reverse proxy with an C# backend using ASP.NET
NGINX / Flask / MongoDB - Sample Python/Flask application 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 React application with a Spring backend and a MySQL database.
React / Express / MySQL - Sample React application with a Node.js backend and a MySQL database.
React / Express / MongoDB - Sample React application with a Node.js backend and a Mongo database.
React / Rust / PostgreSQL - Sample React application with a Rust backend and a Postgres database.
React / Nginx - Sample React application with Nginx.
Spring / PostgreSQL - Sample Java application with Spring framework and a Postgres database.

Single service samples

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

Basic setups for different platforms (not production ready - useful for personal use)

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

Getting started

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

Prerequisites

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.

Running a sample

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

Quickstart guides

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.

Contribute

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