# vaclav-cerny/docker-lemp-stack architecture

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

- Interactive diagram: https://gitdiagram.com/vaclav-cerny/docker-lemp-stack
- Repository: https://github.com/vaclav-cerny/docker-lemp-stack

## Overview

This repository is a Docker-based LEMP hosting stack, not an application framework. The user’s main workflow is to run the setup in production or localhost mode, configure the domain and services, then visit the hosted site; the included PHP page tests MySQL connectivity and displays PHP information. The stack also documents Traefik routing and TLS, plus PhpMyAdmin and Portainer management. The source excerpt covers only the sample PHP page, so setup and service relationships below rely on README statements; unverified wiring is omitted.

Main entry points: [`docker/nginx/nginx.conf`](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/nginx/nginx.conf) (Nginx web server), [`docker/traefik/traefik.toml`](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/traefik/traefik.toml) (Traefik proxy), [`docker/configure.sh`](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/configure.sh) (Stack configurator), [`docker/start.sh`](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/start.sh) (Stack launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and configuration"]
  node_start["Stack launcher<br/>[start.sh]"]
  node_configure["Stack configurator<br/>[configure.sh]"]
  node_compose["Container definition<br/>[docker-compose.yml]"]
  node_nginxconfig["Nginx settings<br/>[nginx.conf]"]
  node_mysqlconfig["MySQL settings<br/>[.env]"]
  node_phpconfig["PHP settings"]
  node_traefikconfig["Traefik settings<br/>[traefik.toml]"]
  node_httpsconfig["HTTPS variant<br/>[traefik.https.toml]"]
end

subgraph group_web["Web and database"]
  node_nginx["Nginx web server<br/>[nginx.conf]"]
  node_php["PHP runtime"]
  node_site["Sample site and DB check<br/>[index.php]"]
  node_mysql[("MySQL database<br/>[.env]")]
end

subgraph group_operations["Routing and management"]
  node_traefik["Traefik proxy<br/>[traefik.toml]"]
  node_pma["PhpMyAdmin<br/>[docker-compose.yml]"]
  node_portainer["Portainer<br/>[docker-compose.yml]"]
end

node_user(("Operator"))
node_dockerhost(("Docker host"))
node_browser(("Site visitor"))

node_user -->|"runs"| node_start
node_start -.->|"configures"| node_configure
node_start -.->|"starts stack"| node_compose
node_user -->|"reconfigures"| node_configure
node_configure -.->|"sets up"| node_nginxconfig
node_configure -.->|"sets up"| node_traefikconfig
node_nginx -->|"uses settings"| node_nginxconfig
node_mysql -->|"uses settings"| node_mysqlconfig
node_php -->|"uses overrides"| node_phpconfig
node_traefik -->|"uses settings"| node_traefikconfig
node_traefik -->|"swaps config"| node_httpsconfig
node_browser -->|"requests services"| node_traefik
node_traefik -.->|"routes requests"| node_nginx
node_nginx -->|"serves PHP"| node_php
node_nginx -->|"serves site"| node_site
node_site -->|"connects to"| node_mysql
node_browser -->|"manages database"| node_pma
node_pma -->|"manages"| node_mysql
node_user -->|"manages containers"| node_portainer
node_portainer -->|"manages"| node_dockerhost
node_compose -.->|"runs containers"| node_dockerhost

click node_start "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/start.sh"
click node_configure "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/configure.sh"
click node_compose "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/docker-compose.yml"
click node_nginxconfig "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/nginx/nginx.conf"
click node_mysqlconfig "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/mysql/.env"
click node_phpconfig "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/php-fpm/php-ini-overrides.ini"
click node_traefikconfig "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/traefik/traefik.toml"
click node_httpsconfig "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/traefik/traefik.https.toml"
click node_nginx "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/nginx/nginx.conf"
click node_php "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/php-fpm/Dockerfile"
click node_site "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/public/index.php"
click node_mysql "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/mysql/.env"
click node_traefik "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/traefik/traefik.toml"
click node_pma "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/docker-compose.yml"
click node_portainer "https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/docker-compose.yml"

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_start,node_configure,node_compose,node_nginxconfig,node_mysqlconfig,node_phpconfig,node_traefikconfig,node_httpsconfig toneBlue
class node_nginx,node_php,node_site,node_mysql toneAmber
class node_traefik,node_pma,node_portainer toneMint
class node_user,node_dockerhost,node_browser toneIndigo
```

## Components

### Setup and configuration

- [Stack launcher](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/start.sh): `docker/start.sh`
- [Stack configurator](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/configure.sh): `docker/configure.sh`
- [Container definition](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/docker-compose.yml): `docker/docker-compose.yml`
- [Nginx settings](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/nginx/nginx.conf): `docker/nginx/nginx.conf`
- [MySQL settings](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/mysql/.env): `docker/mysql/.env`
- [PHP settings](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/php-fpm/php-ini-overrides.ini): `docker/php-fpm/php-ini-overrides.ini`
- [Traefik settings](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/traefik/traefik.toml): `docker/traefik/traefik.toml`
- [HTTPS variant](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/traefik/traefik.https.toml): `docker/traefik/traefik.https.toml`

### Web and database

- [Nginx web server](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/nginx/nginx.conf): `docker/nginx/nginx.conf`
- [PHP runtime](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/php-fpm/Dockerfile): `docker/php-fpm/Dockerfile`
- [Sample site and DB check](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/public/index.php): `public/index.php`
- [MySQL database](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/mysql/.env): `docker/mysql/.env`

### Routing and management

- [Traefik proxy](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/traefik/traefik.toml): `docker/traefik/traefik.toml`
- [PhpMyAdmin](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/docker-compose.yml): `docker/docker-compose.yml`
- [Portainer](https://github.com/vaclav-cerny/docker-lemp-stack/blob/master/docker/docker-compose.yml): `docker/docker-compose.yml`

### Other components

- **Operator**
- **Docker host**
- **Site visitor**

## Connections

- Operator → Stack launcher: runs (evidence: `README.md`)
- Stack launcher → Stack configurator: configures
- Stack launcher → Container definition: starts stack
- Operator → Stack configurator: reconfigures (evidence: `README.md`)
- Stack configurator → Nginx settings: sets up
- Stack configurator → Traefik settings: sets up
- Nginx web server → Nginx settings: uses settings (evidence: `README.md`)
- MySQL database → MySQL settings: uses settings (evidence: `README.md`)
- PHP runtime → PHP settings: uses overrides (evidence: `README.md`)
- Traefik proxy → Traefik settings: uses settings (evidence: `README.md`)
- Traefik proxy → HTTPS variant: swaps config (evidence: `README.md`)
- Site visitor → Traefik proxy: requests services (evidence: `README.md`)
- Traefik proxy → Nginx web server: routes requests
- Nginx web server → PHP runtime: serves PHP (evidence: `README.md`)
- Nginx web server → Sample site and DB check: serves site (evidence: `README.md`)
- Sample site and DB check → MySQL database: connects to (evidence: `public/index.php`)
- Site visitor → PhpMyAdmin: manages database (evidence: `README.md`)
- PhpMyAdmin → MySQL database: manages (evidence: `README.md`)
- Operator → Portainer: manages containers (evidence: `README.md`)
- Portainer → Docker host: manages (evidence: `README.md`)
- Container definition → Docker host: runs containers
