# docker/awesome-compose architecture

> Architecture diagram of the GitHub repository docker/awesome-compose, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/docker/awesome-compose
- Repository: https://github.com/docker/awesome-compose

## Overview

Awesome Compose is a curated collection of Docker Compose samples, not one application. A user chooses a sample stack, then runs its Compose configuration locally; the samples demonstrate different frontend, backend, proxy, database, and messaging combinations. The graph groups representative samples by the README’s categories and includes the documented Wasm examples. The supplied tree omits Compose files and many sample sources, so relationships between individual services are not inferred; the README supports the catalog and local-run workflow.

Main entry points: [`aspnet-mssql/app/aspnetapp/Startup.cs`](https://github.com/docker/awesome-compose/blob/master/aspnet-mssql/app/aspnetapp/Startup.cs) (ASP.NET SQL), [`nginx-golang-mysql/backend/main.go`](https://github.com/docker/awesome-compose/blob/master/nginx-golang-mysql/backend/main.go) (Go MySQL), [`nginx-golang-postgres/backend/main.go`](https://github.com/docker/awesome-compose/blob/master/nginx-golang-postgres/backend/main.go) (Go PostgreSQL), [`sparkjava-mysql/backend/src/main/java/App.java`](https://github.com/docker/awesome-compose/blob/master/sparkjava-mysql/backend/src/main/java/App.java) (Spark MySQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_multi["Multi-service samples"]
  node_aspnet_mssql["ASP.NET SQL<br/>[Startup.cs]"]
  node_go_mysql["Go MySQL<br/>[main.go]"]
  node_go_postgres["Go PostgreSQL<br/>[main.go]"]
  node_spark_mysql["Spark MySQL<br/>[App.java]"]
  node_nginx_aspnet["NGINX ASP.NET<br/>[Program.cs]"]
  node_flask_mongo["Flask MongoDB<br/>[server.py]"]
  node_flask_mysql["Flask MySQL<br/>[hello.py]"]
  node_node_redis["Node Redis<br/>[server.js]"]
  node_react_spring["React Spring"]
  node_react_express_mysql["React Express MySQL<br/>[server.js]"]
  node_react_express_mongo["React Express MongoDB<br/>[server.js]"]
  node_react_rust["React Rust PostgreSQL<br/>[main.rs]"]
  node_spring_postgres["Spring PostgreSQL"]
end

subgraph group_single["Single-service samples"]
  node_angular_sample["Angular<br/>[main.ts]"]
  node_spark_sample["Spark<br/>[App.java]"]
  node_vue_sample["VueJS<br/>[App.vue]"]
  node_flask_sample["Flask<br/>[app.py]"]
  node_php_sample["PHP<br/>[index.php]"]
  node_django_sample["Django<br/>[manage.py]"]
  node_fastapi_sample["FastAPI<br/>[main.py]"]
end

subgraph group_wasm["Wasm samples"]
  node_wasm_mysql["Wasm MySQL NGINX<br/>[main.rs]"]
  node_wasm_kafka["Wasm Kafka MySQL<br/>[main.rs]"]
end

node_user(("Sample user"))
node_compose["Docker Compose"]

node_user -->|"chooses sample"| node_aspnet_mssql
node_user -->|"chooses sample"| node_go_mysql
node_user -->|"chooses sample"| node_go_postgres
node_user -->|"chooses sample"| node_spark_mysql
node_user -->|"chooses sample"| node_nginx_aspnet
node_user -->|"chooses sample"| node_flask_mongo
node_user -->|"chooses sample"| node_flask_mysql
node_user -->|"chooses sample"| node_node_redis
node_user -->|"chooses sample"| node_react_spring
node_user -->|"chooses sample"| node_react_express_mysql
node_user -->|"chooses sample"| node_react_express_mongo
node_user -->|"chooses sample"| node_react_rust
node_user -->|"chooses sample"| node_spring_postgres
node_user -->|"chooses sample"| node_wasm_mysql
node_user -->|"chooses sample"| node_wasm_kafka
node_user -->|"chooses sample"| node_angular_sample
node_user -->|"chooses sample"| node_spark_sample
node_user -->|"chooses sample"| node_vue_sample
node_user -->|"chooses sample"| node_flask_sample
node_user -->|"chooses sample"| node_php_sample
node_user -->|"chooses sample"| node_django_sample
node_user -->|"chooses sample"| node_fastapi_sample
node_user -->|"runs locally"| node_compose

click node_aspnet_mssql "https://github.com/docker/awesome-compose/blob/master/aspnet-mssql/app/aspnetapp/Startup.cs"
click node_go_mysql "https://github.com/docker/awesome-compose/blob/master/nginx-golang-mysql/backend/main.go"
click node_go_postgres "https://github.com/docker/awesome-compose/blob/master/nginx-golang-postgres/backend/main.go"
click node_spark_mysql "https://github.com/docker/awesome-compose/blob/master/sparkjava-mysql/backend/src/main/java/App.java"
click node_nginx_aspnet "https://github.com/docker/awesome-compose/blob/master/nginx-aspnet-mysql/backend/Program.cs"
click node_flask_mongo "https://github.com/docker/awesome-compose/blob/master/nginx-flask-mongo/flask/server.py"
click node_flask_mysql "https://github.com/docker/awesome-compose/blob/master/nginx-flask-mysql/backend/hello.py"
click node_node_redis "https://github.com/docker/awesome-compose/blob/master/nginx-nodejs-redis/web/server.js"
click node_react_spring "https://github.com/docker/awesome-compose/blob/master/react-java-mysql/backend/src/main/java/com/company/project/controllers/HomeController.java"
click node_react_express_mysql "https://github.com/docker/awesome-compose/blob/master/react-express-mysql/backend/src/server.js"
click node_react_express_mongo "https://github.com/docker/awesome-compose/blob/master/react-express-mongodb/backend/server.js"
click node_react_rust "https://github.com/docker/awesome-compose/blob/master/react-rust-postgres/backend/src/main.rs"
click node_spring_postgres "https://github.com/docker/awesome-compose/blob/master/spring-postgres/backend/src/main/java/com/company/project/controllers/HomeController.java"
click node_wasm_mysql "https://github.com/docker/awesome-compose/blob/master/wasmedge-mysql-nginx/backend/src/main.rs"
click node_wasm_kafka "https://github.com/docker/awesome-compose/blob/master/wasmedge-kafka-mysql/etl/src/main.rs"
click node_angular_sample "https://github.com/docker/awesome-compose/blob/master/angular/angular/src/main.ts"
click node_spark_sample "https://github.com/docker/awesome-compose/blob/master/sparkjava/sparkjava/src/main/java/App.java"
click node_vue_sample "https://github.com/docker/awesome-compose/blob/master/vuejs/vuejs/src/App.vue"
click node_flask_sample "https://github.com/docker/awesome-compose/blob/master/flask/app/app.py"
click node_php_sample "https://github.com/docker/awesome-compose/blob/master/apache-php/app/index.php"
click node_django_sample "https://github.com/docker/awesome-compose/blob/master/django/app/manage.py"
click node_fastapi_sample "https://github.com/docker/awesome-compose/blob/master/fastapi/app/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_aspnet_mssql,node_go_mysql,node_go_postgres,node_spark_mysql,node_nginx_aspnet,node_flask_mongo,node_flask_mysql,node_node_redis,node_react_spring,node_react_express_mysql,node_react_express_mongo,node_react_rust,node_spring_postgres,node_user toneBlue
class node_angular_sample,node_spark_sample,node_vue_sample,node_flask_sample,node_php_sample,node_django_sample,node_fastapi_sample toneAmber
class node_wasm_mysql,node_wasm_kafka toneMint
class node_compose toneIndigo
```

## Components

### Multi-service samples

- [ASP.NET SQL](https://github.com/docker/awesome-compose/blob/master/aspnet-mssql/app/aspnetapp/Startup.cs): `aspnet-mssql/app/aspnetapp/Startup.cs`
- [Go MySQL](https://github.com/docker/awesome-compose/blob/master/nginx-golang-mysql/backend/main.go): `nginx-golang-mysql/backend/main.go`
- [Go PostgreSQL](https://github.com/docker/awesome-compose/blob/master/nginx-golang-postgres/backend/main.go): `nginx-golang-postgres/backend/main.go`
- [Spark MySQL](https://github.com/docker/awesome-compose/blob/master/sparkjava-mysql/backend/src/main/java/App.java): `sparkjava-mysql/backend/src/main/java/App.java`
- [NGINX ASP.NET](https://github.com/docker/awesome-compose/blob/master/nginx-aspnet-mysql/backend/Program.cs): `nginx-aspnet-mysql/backend/Program.cs`
- [Flask MongoDB](https://github.com/docker/awesome-compose/blob/master/nginx-flask-mongo/flask/server.py): `nginx-flask-mongo/flask/server.py`
- [Flask MySQL](https://github.com/docker/awesome-compose/blob/master/nginx-flask-mysql/backend/hello.py): `nginx-flask-mysql/backend/hello.py`
- [Node Redis](https://github.com/docker/awesome-compose/blob/master/nginx-nodejs-redis/web/server.js): `nginx-nodejs-redis/web/server.js`
- [React Spring](https://github.com/docker/awesome-compose/blob/master/react-java-mysql/backend/src/main/java/com/company/project/controllers/HomeController.java): `react-java-mysql/backend/src/main/java/com/company/project/controllers/HomeController.java`
- [React Express MySQL](https://github.com/docker/awesome-compose/blob/master/react-express-mysql/backend/src/server.js): `react-express-mysql/backend/src/server.js`
- [React Express MongoDB](https://github.com/docker/awesome-compose/blob/master/react-express-mongodb/backend/server.js): `react-express-mongodb/backend/server.js`
- [React Rust PostgreSQL](https://github.com/docker/awesome-compose/blob/master/react-rust-postgres/backend/src/main.rs): `react-rust-postgres/backend/src/main.rs`
- [Spring PostgreSQL](https://github.com/docker/awesome-compose/blob/master/spring-postgres/backend/src/main/java/com/company/project/controllers/HomeController.java): `spring-postgres/backend/src/main/java/com/company/project/controllers/HomeController.java`

### Single-service samples

- [Angular](https://github.com/docker/awesome-compose/blob/master/angular/angular/src/main.ts): `angular/angular/src/main.ts`
- [Spark](https://github.com/docker/awesome-compose/blob/master/sparkjava/sparkjava/src/main/java/App.java): `sparkjava/sparkjava/src/main/java/App.java`
- [VueJS](https://github.com/docker/awesome-compose/blob/master/vuejs/vuejs/src/App.vue): `vuejs/vuejs/src/App.vue`
- [Flask](https://github.com/docker/awesome-compose/blob/master/flask/app/app.py): `flask/app/app.py`
- [PHP](https://github.com/docker/awesome-compose/blob/master/apache-php/app/index.php): `apache-php/app/index.php`
- [Django](https://github.com/docker/awesome-compose/blob/master/django/app/manage.py): `django/app/manage.py`
- [FastAPI](https://github.com/docker/awesome-compose/blob/master/fastapi/app/main.py): `fastapi/app/main.py`

### Wasm samples

- [Wasm MySQL NGINX](https://github.com/docker/awesome-compose/blob/master/wasmedge-mysql-nginx/backend/src/main.rs): `wasmedge-mysql-nginx/backend/src/main.rs`
- [Wasm Kafka MySQL](https://github.com/docker/awesome-compose/blob/master/wasmedge-kafka-mysql/etl/src/main.rs): `wasmedge-kafka-mysql/etl/src/main.rs`

### Other components

- **Sample user**
- **Docker Compose**

## Connections

- Sample user → ASP.NET SQL: chooses sample (evidence: `README.md`)
- Sample user → Go MySQL: chooses sample (evidence: `README.md`)
- Sample user → Go PostgreSQL: chooses sample (evidence: `README.md`)
- Sample user → Spark MySQL: chooses sample (evidence: `README.md`)
- Sample user → NGINX ASP.NET: chooses sample (evidence: `README.md`)
- Sample user → Flask MongoDB: chooses sample (evidence: `README.md`)
- Sample user → Flask MySQL: chooses sample (evidence: `README.md`)
- Sample user → Node Redis: chooses sample (evidence: `README.md`)
- Sample user → React Spring: chooses sample (evidence: `README.md`)
- Sample user → React Express MySQL: chooses sample (evidence: `README.md`)
- Sample user → React Express MongoDB: chooses sample (evidence: `README.md`)
- Sample user → React Rust PostgreSQL: chooses sample (evidence: `README.md`)
- Sample user → Spring PostgreSQL: chooses sample (evidence: `README.md`)
- Sample user → Wasm MySQL NGINX: chooses sample (evidence: `README.md`)
- Sample user → Wasm Kafka MySQL: chooses sample (evidence: `README.md`)
- Sample user → Angular: chooses sample (evidence: `README.md`)
- Sample user → Spark: chooses sample (evidence: `README.md`)
- Sample user → VueJS: chooses sample (evidence: `README.md`)
- Sample user → Flask: chooses sample (evidence: `README.md`)
- Sample user → PHP: chooses sample (evidence: `README.md`)
- Sample user → Django: chooses sample (evidence: `README.md`)
- Sample user → FastAPI: chooses sample (evidence: `README.md`)
- Sample user → Docker Compose: runs locally (evidence: `README.md`)
