# vasanthan100/awesome-compose architecture

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

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

## Overview

Awesome Compose is a catalog of Docker Compose examples, not one integrated application. Its principal workflow is for a developer to choose a sample, start its described services with Docker Compose in a local development environment, and inspect the sample-specific README for expected behavior. The catalog spans multi-service stacks, single-service examples, and basic platform setups; the tree shown contains source for only some entries. The supplied excerpts do not show Compose definitions, so service-level wiring is not mapped here.

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

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_multi["Multi-service samples"]
  node_aspnet_mssql["ASP.NET / MS-SQL<br/>[HomeController.cs]"]
  node_go_mysql["Go / NGINX / MySQL<br/>[main.go]"]
  node_go_postgres["Go / NGINX / PostgreSQL<br/>[main.go]"]
  node_spark_mysql["Java Spark / MySQL<br/>[App.java]"]
  node_nginx_aspnet["NGINX / ASP.NET / MySQL<br/>[Program.cs]"]
  node_flask_mongo["NGINX / Flask / MongoDB<br/>[server.py]"]
  node_flask_mysql["NGINX / Flask / MySQL<br/>[hello.py]"]
  node_node_redis["NGINX / Node.js / Redis<br/>[server.js]"]
  node_nginx_go["NGINX / Go<br/>[main.go]"]
  node_wsgi_flask["NGINX / WSGI / Flask<br/>[app.py]"]
  node_flask_redis["Python / Flask / Redis<br/>[app.py]"]
  node_react_spring["React / Spring / MySQL"]
  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_react_nginx["React / Nginx<br/>[App.js]"]
  node_spring_postgres["Spring / PostgreSQL"]
  node_wasm_mysql["WasmEdge / MySQL / NGINX<br/>[main.rs]"]
  node_wasm_kafka["WasmEdge / Kafka / MySQL<br/>[main.rs]"]
  node_elasticsearch_stack["Elasticsearch / Logstash / Kibana"]
  node_postgres_pgadmin["PostgreSQL / pgAdmin"]
end

subgraph group_single["Single-service samples"]
  node_angular["Angular<br/>[app.module.ts]"]
  node_spark["Spark<br/>[App.java]"]
  node_vue["VueJS<br/>[App.vue]"]
  node_flask["Flask<br/>[app.py]"]
  node_php["PHP<br/>[index.php]"]
  node_traefik["Traefik<br/>[main.go]"]
  node_django["Django<br/>[manage.py]"]
  node_fastapi["FastAPI<br/>[main.py]"]
end

subgraph group_basic["Basic setups"]
  node_platform_setups["Platform setups"]
  node_gitea_postgres["Gitea / PostgreSQL"]
  node_nextcloud_postgres["Nextcloud / PostgreSQL"]
end

node_developer(("Developer"))
node_compose["Docker Compose"]

node_developer -->|"starts sample"| node_compose
node_compose -->|"runs locally"| node_aspnet_mssql
node_compose -->|"runs locally"| node_go_mysql
node_compose -->|"runs locally"| node_go_postgres
node_compose -->|"runs locally"| node_spark_mysql
node_compose -->|"runs locally"| node_nginx_aspnet
node_compose -->|"runs locally"| node_flask_mongo
node_compose -->|"runs locally"| node_flask_mysql
node_compose -->|"runs locally"| node_node_redis
node_compose -->|"runs locally"| node_nginx_go
node_compose -->|"runs locally"| node_wsgi_flask
node_compose -->|"runs locally"| node_flask_redis
node_compose -->|"runs locally"| node_react_spring
node_compose -->|"runs locally"| node_react_express_mysql
node_compose -->|"runs locally"| node_react_express_mongo
node_compose -->|"runs locally"| node_react_rust
node_compose -->|"runs locally"| node_react_nginx
node_compose -->|"runs locally"| node_spring_postgres
node_compose -->|"runs locally"| node_wasm_mysql
node_compose -->|"runs locally"| node_wasm_kafka
node_compose -->|"runs locally"| node_elasticsearch_stack
node_compose -->|"runs locally"| node_postgres_pgadmin
node_compose -->|"runs locally"| node_angular
node_compose -->|"runs locally"| node_spark
node_compose -->|"runs locally"| node_vue
node_compose -->|"runs locally"| node_flask
node_compose -->|"runs locally"| node_php
node_compose -->|"runs locally"| node_traefik
node_compose -->|"runs locally"| node_django
node_compose -->|"runs locally"| node_fastapi
node_compose -->|"runs locally"| node_platform_setups
node_compose -->|"runs locally"| node_gitea_postgres
node_compose -->|"runs locally"| node_nextcloud_postgres

click node_aspnet_mssql "https://github.com/vasanthan100/awesome-compose/blob/master/aspnet-mssql/app/aspnetapp/Controllers/HomeController.cs"
click node_go_mysql "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-golang-mysql/backend/main.go"
click node_go_postgres "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-golang-postgres/backend/main.go"
click node_spark_mysql "https://github.com/vasanthan100/awesome-compose/blob/master/sparkjava-mysql/backend/src/main/java/App.java"
click node_nginx_aspnet "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-aspnet-mysql/backend/Program.cs"
click node_flask_mongo "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-flask-mongo/flask/server.py"
click node_flask_mysql "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-flask-mysql/backend/hello.py"
click node_node_redis "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-nodejs-redis/web/server.js"
click node_nginx_go "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-golang/backend/main.go"
click node_wsgi_flask "https://github.com/vasanthan100/awesome-compose/blob/master/nginx-wsgi-flask/flask/app.py"
click node_flask_redis "https://github.com/vasanthan100/awesome-compose/blob/master/flask-redis/app.py"
click node_react_spring "https://github.com/vasanthan100/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/vasanthan100/awesome-compose/blob/master/react-express-mysql/backend/src/server.js"
click node_react_express_mongo "https://github.com/vasanthan100/awesome-compose/blob/master/react-express-mongodb/backend/server.js"
click node_react_rust "https://github.com/vasanthan100/awesome-compose/blob/master/react-rust-postgres/backend/src/main.rs"
click node_react_nginx "https://github.com/vasanthan100/awesome-compose/blob/master/react-nginx/src/App.js"
click node_spring_postgres "https://github.com/vasanthan100/awesome-compose/blob/master/spring-postgres/backend/src/main/java/com/company/project/controllers/HomeController.java"
click node_wasm_mysql "https://github.com/vasanthan100/awesome-compose/blob/master/wasmedge-mysql-nginx/backend/src/main.rs"
click node_wasm_kafka "https://github.com/vasanthan100/awesome-compose/blob/master/wasmedge-kafka-mysql/etl/src/main.rs"
click node_angular "https://github.com/vasanthan100/awesome-compose/blob/master/angular/angular/src/app/app.module.ts"
click node_spark "https://github.com/vasanthan100/awesome-compose/blob/master/sparkjava/sparkjava/src/main/java/App.java"
click node_vue "https://github.com/vasanthan100/awesome-compose/blob/master/vuejs/vuejs/src/App.vue"
click node_flask "https://github.com/vasanthan100/awesome-compose/blob/master/flask/app/app.py"
click node_php "https://github.com/vasanthan100/awesome-compose/blob/master/apache-php/app/index.php"
click node_traefik "https://github.com/vasanthan100/awesome-compose/blob/master/traefik-golang/backend/main.go"
click node_django "https://github.com/vasanthan100/awesome-compose/blob/master/django/app/manage.py"
click node_fastapi "https://github.com/vasanthan100/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_nginx_go,node_wsgi_flask,node_flask_redis,node_react_spring,node_react_express_mysql,node_react_express_mongo,node_react_rust,node_react_nginx,node_spring_postgres,node_wasm_mysql,node_wasm_kafka,node_elasticsearch_stack,node_postgres_pgadmin toneBlue
class node_angular,node_spark,node_vue,node_flask,node_php,node_traefik,node_django,node_fastapi toneAmber
class node_platform_setups,node_gitea_postgres,node_nextcloud_postgres toneMint
class node_developer,node_compose toneIndigo
```

## Components

### Multi-service samples

- [ASP.NET / MS-SQL](https://github.com/vasanthan100/awesome-compose/blob/master/aspnet-mssql/app/aspnetapp/Controllers/HomeController.cs): `aspnet-mssql/app/aspnetapp/Controllers/HomeController.cs`
- [Go / NGINX / MySQL](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-golang-mysql/backend/main.go): `nginx-golang-mysql/backend/main.go`
- [Go / NGINX / PostgreSQL](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-golang-postgres/backend/main.go): `nginx-golang-postgres/backend/main.go`
- [Java Spark / MySQL](https://github.com/vasanthan100/awesome-compose/blob/master/sparkjava-mysql/backend/src/main/java/App.java): `sparkjava-mysql/backend/src/main/java/App.java`
- [NGINX / ASP.NET / MySQL](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-aspnet-mysql/backend/Program.cs): `nginx-aspnet-mysql/backend/Program.cs`
- [NGINX / Flask / MongoDB](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-flask-mongo/flask/server.py): `nginx-flask-mongo/flask/server.py`
- [NGINX / Flask / MySQL](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-flask-mysql/backend/hello.py): `nginx-flask-mysql/backend/hello.py`
- [NGINX / Node.js / Redis](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-nodejs-redis/web/server.js): `nginx-nodejs-redis/web/server.js`
- [NGINX / Go](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-golang/backend/main.go): `nginx-golang/backend/main.go`
- [NGINX / WSGI / Flask](https://github.com/vasanthan100/awesome-compose/blob/master/nginx-wsgi-flask/flask/app.py): `nginx-wsgi-flask/flask/app.py`
- [Python / Flask / Redis](https://github.com/vasanthan100/awesome-compose/blob/master/flask-redis/app.py): `flask-redis/app.py`
- [React / Spring / MySQL](https://github.com/vasanthan100/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/vasanthan100/awesome-compose/blob/master/react-express-mysql/backend/src/server.js): `react-express-mysql/backend/src/server.js`
- [React / Express / MongoDB](https://github.com/vasanthan100/awesome-compose/blob/master/react-express-mongodb/backend/server.js): `react-express-mongodb/backend/server.js`
- [React / Rust / PostgreSQL](https://github.com/vasanthan100/awesome-compose/blob/master/react-rust-postgres/backend/src/main.rs): `react-rust-postgres/backend/src/main.rs`
- [React / Nginx](https://github.com/vasanthan100/awesome-compose/blob/master/react-nginx/src/App.js): `react-nginx/src/App.js`
- [Spring / PostgreSQL](https://github.com/vasanthan100/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`
- [WasmEdge / MySQL / NGINX](https://github.com/vasanthan100/awesome-compose/blob/master/wasmedge-mysql-nginx/backend/src/main.rs): `wasmedge-mysql-nginx/backend/src/main.rs`
- [WasmEdge / Kafka / MySQL](https://github.com/vasanthan100/awesome-compose/blob/master/wasmedge-kafka-mysql/etl/src/main.rs): `wasmedge-kafka-mysql/etl/src/main.rs`
- **Elasticsearch / Logstash / Kibana**
- **PostgreSQL / pgAdmin**

### Single-service samples

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

### Basic setups

- **Platform setups**
- **Gitea / PostgreSQL**
- **Nextcloud / PostgreSQL**

### Other components

- **Developer**
- **Docker Compose**

## Connections

- Developer → Docker Compose: starts sample (evidence: `README.md`)
- Docker Compose → ASP.NET / MS-SQL: runs locally (evidence: `README.md`)
- Docker Compose → Go / NGINX / MySQL: runs locally (evidence: `README.md`)
- Docker Compose → Go / NGINX / PostgreSQL: runs locally (evidence: `README.md`)
- Docker Compose → Java Spark / MySQL: runs locally (evidence: `README.md`)
- Docker Compose → NGINX / ASP.NET / MySQL: runs locally (evidence: `README.md`)
- Docker Compose → NGINX / Flask / MongoDB: runs locally (evidence: `README.md`)
- Docker Compose → NGINX / Flask / MySQL: runs locally (evidence: `README.md`)
- Docker Compose → NGINX / Node.js / Redis: runs locally (evidence: `README.md`)
- Docker Compose → NGINX / Go: runs locally (evidence: `README.md`)
- Docker Compose → NGINX / WSGI / Flask: runs locally (evidence: `README.md`)
- Docker Compose → Python / Flask / Redis: runs locally (evidence: `README.md`)
- Docker Compose → React / Spring / MySQL: runs locally (evidence: `README.md`)
- Docker Compose → React / Express / MySQL: runs locally (evidence: `README.md`)
- Docker Compose → React / Express / MongoDB: runs locally (evidence: `README.md`)
- Docker Compose → React / Rust / PostgreSQL: runs locally (evidence: `README.md`)
- Docker Compose → React / Nginx: runs locally (evidence: `README.md`)
- Docker Compose → Spring / PostgreSQL: runs locally (evidence: `README.md`)
- Docker Compose → WasmEdge / MySQL / NGINX: runs locally (evidence: `README.md`)
- Docker Compose → WasmEdge / Kafka / MySQL: runs locally (evidence: `README.md`)
- Docker Compose → Elasticsearch / Logstash / Kibana: runs locally (evidence: `README.md`)
- Docker Compose → PostgreSQL / pgAdmin: runs locally (evidence: `README.md`)
- Docker Compose → Angular: runs locally (evidence: `README.md`)
- Docker Compose → Spark: runs locally (evidence: `README.md`)
- Docker Compose → VueJS: runs locally (evidence: `README.md`)
- Docker Compose → Flask: runs locally (evidence: `README.md`)
- Docker Compose → PHP: runs locally (evidence: `README.md`)
- Docker Compose → Traefik: runs locally (evidence: `README.md`)
- Docker Compose → Django: runs locally (evidence: `README.md`)
- Docker Compose → FastAPI: runs locally (evidence: `README.md`)
- Docker Compose → Platform setups: runs locally (evidence: `README.md`)
- Docker Compose → Gitea / PostgreSQL: runs locally (evidence: `README.md`)
- Docker Compose → Nextcloud / PostgreSQL: runs locally (evidence: `README.md`)
