# dpsg-eschborn/infrastructure-configs architecture

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

- Interactive diagram: https://gitdiagram.com/dpsg-eschborn/infrastructure-configs
- Repository: https://github.com/dpsg-eschborn/infrastructure-configs

## Overview

Pfadfinder-Cloud is a beginner-oriented server provisioning toolkit: users start an installer or the documented manual bootstrap, choose a server setup and modules, then receive a configured host. The README documents Hetzner creation, SSH setup of an existing server, local Homeserver setup, and background SSL/database configuration. It also identifies Traefik and Nextcloud, Storage Box, and website extensions in the tree. Source excerpts were unavailable, so edges are limited to README-documented relationships; extension dispatch details are not inferred.

Main entry points: [`engine/setup.sh`](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/engine/setup.sh) (Setup engine), [`engine/bootstrap.sh`](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/engine/bootstrap.sh) (Manual bootstrap), [`install.bat`](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.bat) (Windows installer), [`install.ps1`](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.ps1) (PowerShell installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_onboarding["Setup entrypoints"]
  node_win_installer["Windows installer<br/>[install.bat]"]
  node_ps_installer["PowerShell installer<br/>[install.ps1]"]
  node_unix_installer["Linux/macOS installer<br/>[install.sh]"]
  node_bootstrap["Manual bootstrap<br/>[bootstrap.sh]"]
end

subgraph group_provisioning["Server provisioning"]
  node_setup["Setup engine<br/>[setup.sh]"]
  node_hetzner["Hetzner Cloud"]
  node_existing_host["Existing SSH host"]
  node_local_host["Local Homeserver"]
  node_cloud_config["Hetzner cloud config"]
end

subgraph group_platform["Core platform"]
  node_traefik["Traefik proxy<br/>[docker-compose.yml]"]
end

subgraph group_extensions["Optional extensions"]
  node_nextcloud["Nextcloud<br/>[docker-compose.yml]"]
  node_storagebox["Storage Box integration<br/>[configure.sh]"]
  node_website["Website extension<br/>[docker-compose.yml]"]
end

node_operator(("Server operator"))

node_operator -->|"starts"| node_win_installer
node_operator -->|"starts"| node_ps_installer
node_operator -->|"starts"| node_unix_installer
node_operator -->|"runs manually"| node_bootstrap
node_operator -->|"configures server with"| node_cloud_config
node_operator -->|"creates server at"| node_hetzner
node_operator -->|"sets up over SSH"| node_existing_host
node_operator -->|"configures directly"| node_local_host
node_bootstrap -.->|"starts setup"| node_setup
node_setup -.->|"configures platform"| node_traefik
node_setup -.->|"may install"| node_nextcloud
node_setup -.->|"may configure"| node_storagebox
node_setup -.->|"may install"| node_website

click node_win_installer "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.bat"
click node_ps_installer "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.ps1"
click node_unix_installer "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.sh"
click node_bootstrap "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/engine/bootstrap.sh"
click node_setup "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/engine/setup.sh"
click node_cloud_config "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/cloud-configs/hetzner-basic-node.yaml"
click node_traefik "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/core/traefik/docker-compose.yml"
click node_nextcloud "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/extensions/nextcloud/docker-compose.yml"
click node_storagebox "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/extensions/storagebox/configure.sh"
click node_website "https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/extensions/website/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_win_installer,node_ps_installer,node_unix_installer,node_bootstrap toneBlue
class node_setup,node_hetzner,node_existing_host,node_local_host,node_cloud_config toneAmber
class node_traefik,node_operator toneMint
class node_nextcloud,node_storagebox,node_website toneRose
```

## Components

### Setup entrypoints

- [Windows installer](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.bat): `install.bat`
- [PowerShell installer](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.ps1): `install.ps1`
- [Linux/macOS installer](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/install.sh): `install.sh`
- [Manual bootstrap](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/engine/bootstrap.sh): `engine/bootstrap.sh`

### Server provisioning

- [Setup engine](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/engine/setup.sh): `engine/setup.sh`
- **Hetzner Cloud**
- **Existing SSH host**
- **Local Homeserver**
- [Hetzner cloud config](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/cloud-configs/hetzner-basic-node.yaml): `cloud-configs/hetzner-basic-node.yaml`

### Core platform

- [Traefik proxy](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/core/traefik/docker-compose.yml): `core/traefik/docker-compose.yml`

### Optional extensions

- [Nextcloud](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/extensions/nextcloud/docker-compose.yml): `extensions/nextcloud/docker-compose.yml`
- [Storage Box integration](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/extensions/storagebox/configure.sh): `extensions/storagebox/configure.sh`
- [Website extension](https://github.com/dpsg-eschborn/infrastructure-configs/blob/main/extensions/website/docker-compose.yml): `extensions/website/docker-compose.yml`

### Other components

- **Server operator**

## Connections

- Server operator → Windows installer: starts (evidence: `README.md`)
- Server operator → PowerShell installer: starts (evidence: `README.md`)
- Server operator → Linux/macOS installer: starts (evidence: `README.md`)
- Server operator → Manual bootstrap: runs manually (evidence: `README.md`)
- Server operator → Hetzner cloud config: configures server with (evidence: `README.md`)
- Server operator → Hetzner Cloud: creates server at (evidence: `README.md`)
- Server operator → Existing SSH host: sets up over SSH (evidence: `README.md`)
- Server operator → Local Homeserver: configures directly (evidence: `README.md`)
- Manual bootstrap → Setup engine: starts setup
- Setup engine → Traefik proxy: configures platform
- Setup engine → Nextcloud: may install
- Setup engine → Storage Box integration: may configure
- Setup engine → Website extension: may install
