# simplehomelab/docker-traefik architecture

> Architecture diagram of the GitHub repository simplehomelab/docker-traefik, 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/simplehomelab/docker-traefik
- Repository: https://github.com/simplehomelab/docker-traefik

## Overview

This repository is a collection of production homelab Docker configurations, organized into host-specific Compose stacks and supporting service configuration. The principal workflow is choosing a host’s stack and running its services; internet-facing applications can then be exposed through Traefik, with authentication and security options. Other major branches include media services, databases, monitoring, automation, and a separate Nginx/PHP web-server setup. No source excerpts were provided, so relationships below rely on README statements; configuration-level interactions are not inferred.

Main entry points: [`compose`](https://github.com/simplehomelab/docker-traefik/tree/main/compose) (Host Compose stacks), [`compose/hs/traefik.yml`](https://github.com/simplehomelab/docker-traefik/blob/main/compose/hs/traefik.yml) (Traefik proxy), [`compose/hs`](https://github.com/simplehomelab/docker-traefik/tree/main/compose/hs) (Home server), [`compose/mds`](https://github.com/simplehomelab/docker-traefik/tree/main/compose/mds) (Media server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_stacks["Host Stacks"]
  node_hoststacks["Host Compose stacks"]
  node_home["Home server"]
  node_media["Media server"]
  node_webhost["Web host"]
  node_nas["Synology host"]
end

subgraph group_access["Remote Access"]
  node_traefik["Traefik proxy<br/>[traefik.yml]"]
  node_routes["Proxy rules"]
  node_auth["Authentication<br/>[oauth.yml]"]
  node_crowdsec["Threat protection<br/>[crowdsec.yml]"]
end

subgraph group_web["Web Serving"]
  node_nginx["Nginx web server<br/>[nginx.yml]"]
  node_php["PHP runtime<br/>[php8.yml]"]
  node_nginxconf["Nginx configuration"]
end

subgraph group_services["Homelab Services"]
  node_mediaapps["Media applications"]
  node_databases[("Databases")]
  node_monitoring["Monitoring"]
  node_automation["Automation tools"]
  node_storage["Remote storage<br/>[rclone-gdrive.yml]"]
end

node_operator(("Homelab operator"))

node_operator -->|"chooses stack"| node_hoststacks
node_hoststacks -->|"organizes by host"| node_home
node_hoststacks -->|"organizes by host"| node_media
node_hoststacks -->|"organizes by host"| node_webhost
node_hoststacks -->|"organizes by host"| node_nas
node_operator -->|"exposes apps"| node_traefik
node_traefik -.->|"routes traffic"| node_routes
node_operator -->|"secures apps"| node_auth
node_operator -->|"adds protection"| node_crowdsec
node_operator -->|"runs web stack"| node_nginx
node_operator -->|"runs web stack"| node_php
node_operator -.->|"configures web server"| node_nginxconf
node_operator -->|"runs media services"| node_mediaapps
node_operator -->|"runs databases"| node_databases
node_operator -->|"runs monitoring"| node_monitoring
node_operator -->|"runs automation"| node_automation
node_operator -->|"mounts remote folders"| node_storage

click node_hoststacks "https://github.com/simplehomelab/docker-traefik/tree/main/compose"
click node_home "https://github.com/simplehomelab/docker-traefik/tree/main/compose/hs"
click node_media "https://github.com/simplehomelab/docker-traefik/tree/main/compose/mds"
click node_webhost "https://github.com/simplehomelab/docker-traefik/tree/main/compose/ws-arm"
click node_nas "https://github.com/simplehomelab/docker-traefik/tree/main/compose/ds918"
click node_traefik "https://github.com/simplehomelab/docker-traefik/blob/main/compose/hs/traefik.yml"
click node_routes "https://github.com/simplehomelab/docker-traefik/tree/main/appdata/traefik3/rules"
click node_auth "https://github.com/simplehomelab/docker-traefik/blob/main/compose/hs/oauth.yml"
click node_crowdsec "https://github.com/simplehomelab/docker-traefik/blob/main/compose/ws-arm/crowdsec.yml"
click node_nginx "https://github.com/simplehomelab/docker-traefik/blob/main/compose/ws-arm/nginx.yml"
click node_php "https://github.com/simplehomelab/docker-traefik/blob/main/compose/ws-arm/php8.yml"
click node_nginxconf "https://github.com/simplehomelab/docker-traefik/tree/main/appdata/nginx"
click node_mediaapps "https://github.com/simplehomelab/docker-traefik/tree/main/compose/mds"
click node_databases "https://github.com/simplehomelab/docker-traefik/tree/main/compose/mds"
click node_monitoring "https://github.com/simplehomelab/docker-traefik/tree/main/compose/ws-arm"
click node_automation "https://github.com/simplehomelab/docker-traefik/tree/main/compose/ws-arm"
click node_storage "https://github.com/simplehomelab/docker-traefik/blob/main/compose/ds918/rclone-gdrive.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_hoststacks,node_home,node_media,node_webhost,node_nas toneBlue
class node_traefik,node_routes,node_auth,node_crowdsec toneAmber
class node_nginx,node_php,node_nginxconf toneMint
class node_mediaapps,node_databases,node_monitoring,node_automation,node_storage toneRose
class node_operator toneIndigo
```

## Components

### Host Stacks

- [Host Compose stacks](https://github.com/simplehomelab/docker-traefik/tree/main/compose): `compose`
- [Home server](https://github.com/simplehomelab/docker-traefik/tree/main/compose/hs): `compose/hs`
- [Media server](https://github.com/simplehomelab/docker-traefik/tree/main/compose/mds): `compose/mds`
- [Web host](https://github.com/simplehomelab/docker-traefik/tree/main/compose/ws-arm): `compose/ws-arm`
- [Synology host](https://github.com/simplehomelab/docker-traefik/tree/main/compose/ds918): `compose/ds918`

### Remote Access

- [Traefik proxy](https://github.com/simplehomelab/docker-traefik/blob/main/compose/hs/traefik.yml): `compose/hs/traefik.yml`
- [Proxy rules](https://github.com/simplehomelab/docker-traefik/tree/main/appdata/traefik3/rules): `appdata/traefik3/rules`
- [Authentication](https://github.com/simplehomelab/docker-traefik/blob/main/compose/hs/oauth.yml): `compose/hs/oauth.yml`
- [Threat protection](https://github.com/simplehomelab/docker-traefik/blob/main/compose/ws-arm/crowdsec.yml): `compose/ws-arm/crowdsec.yml`

### Web Serving

- [Nginx web server](https://github.com/simplehomelab/docker-traefik/blob/main/compose/ws-arm/nginx.yml): `compose/ws-arm/nginx.yml`
- [PHP runtime](https://github.com/simplehomelab/docker-traefik/blob/main/compose/ws-arm/php8.yml): `compose/ws-arm/php8.yml`
- [Nginx configuration](https://github.com/simplehomelab/docker-traefik/tree/main/appdata/nginx): `appdata/nginx`

### Homelab Services

- [Media applications](https://github.com/simplehomelab/docker-traefik/tree/main/compose/mds): `compose/mds`
- [Databases](https://github.com/simplehomelab/docker-traefik/tree/main/compose/mds): `compose/mds`
- [Monitoring](https://github.com/simplehomelab/docker-traefik/tree/main/compose/ws-arm): `compose/ws-arm`
- [Automation tools](https://github.com/simplehomelab/docker-traefik/tree/main/compose/ws-arm): `compose/ws-arm`
- [Remote storage](https://github.com/simplehomelab/docker-traefik/blob/main/compose/ds918/rclone-gdrive.yml): `compose/ds918/rclone-gdrive.yml`

### Other components

- **Homelab operator**

## Connections

- Homelab operator → Host Compose stacks: chooses stack (evidence: `README.md`)
- Host Compose stacks → Home server: organizes by host (evidence: `README.md`)
- Host Compose stacks → Media server: organizes by host (evidence: `README.md`)
- Host Compose stacks → Web host: organizes by host (evidence: `README.md`)
- Host Compose stacks → Synology host: organizes by host (evidence: `README.md`)
- Homelab operator → Traefik proxy: exposes apps (evidence: `README.md`)
- Traefik proxy → Proxy rules: routes traffic
- Homelab operator → Authentication: secures apps (evidence: `README.md`)
- Homelab operator → Threat protection: adds protection (evidence: `README.md`)
- Homelab operator → Nginx web server: runs web stack (evidence: `README.md`)
- Homelab operator → PHP runtime: runs web stack (evidence: `README.md`)
- Homelab operator → Nginx configuration: configures web server
- Homelab operator → Media applications: runs media services (evidence: `README.md`)
- Homelab operator → Databases: runs databases (evidence: `README.md`)
- Homelab operator → Monitoring: runs monitoring (evidence: `README.md`)
- Homelab operator → Automation tools: runs automation (evidence: `README.md`)
- Homelab operator → Remote storage: mounts remote folders (evidence: `README.md`)
