> ## Content Index
> Fetch the complete content index at: https://kisium.de/llms.txt
> Use this file to discover other available public pages before exploring further.

# Mein Server als Code: was ich beim Aufschreiben gefunden habe
- URL: https://kisium.de/ansible-infrastruktur-als-code/
- Published: 2026-11-06T19:30:00.000Z
- Updated: 2026-11-13T12:20:27.000Z
- Description: Ich wollte den Server nur dokumentieren – und fand ein anderes Betriebssystem, mehr Container als gedacht und ein Passwort im Klartext.
- Author: Tobias Peine
- Tags: Mein Weg, Ansible

> Dieser Text gehört zur Reihe „Mein Weg“. Vorher: [Mein Homelab](https://kisium.de/mein-homelab/).

Nach dem Homelab-Artikel kam eine Rückfrage, die ich nicht beantworten konnte: „Wenn dein Server morgen weg ist – wie lange brauchst du, bis alles wieder läuft?" Meine ehrliche Antwort war: keine Ahnung. Ich hatte einen Server, den ich über Monate von Hand aufgebaut hatte, und ein gutes Gefühl. Kein Repository.

Das habe ich geändert. Und dabei herausgefunden, dass mein Server nicht das war, was ich über ihn erzählt hatte.

## Warum ein Repository und nicht ein Backup

Ein Backup rettet den Zustand. Es erklärt ihn nicht. Wenn in zwei Jahren ein Zertifikat abläuft oder ein Container nicht mehr startet, hilft mir ein Tarball nur begrenzt – ich sehe dann, *dass* etwas so war, aber nicht *warum*.

Ein Ansible-Repository ist die Begründung in ausführbarer Form. Jede Zeile sagt: dieser Port ist zu, weil; dieser Dienst hängt nur an Loopback, weil. Das ist gleichzeitig der Nachweis, den ich in einem Bewerbungsgespräch zeigen kann: nicht „ich habe Docker gelernt", sondern „hier ist das Repository, das meinen Server aus dem Nichts aufbaut".

Also habe ich angefangen aufzuschreiben, was läuft. Und beim Aufschreiben gemerkt, dass ich es nicht wusste.

## Der erste Schlag: das falsche Betriebssystem

In meinen Notizen stand seit Monaten „Debian 12". Im README des Repos stand es auch. Beim ersten Blick auf den Server:

```
$ . /etc/os-release; echo "$PRETTY_NAME"
Ubuntu 24.04.5 LTS

```

Kein Tippfehler, kein Versehen. Ich hatte die ganze Zeit Ubuntu vor mir und Debian aufgeschrieben, weil Debian in meinem Kopf die „richtige" Serverdistribution war. Das ist der Moment, in dem Dokumentation aufhört, Dokumentation zu sein, und Behauptung wird.

Ein Betriebssystem ist kein Detail. Die Paketquellen, die Python-Version, der Pfad zum Interpreter – alles hängt daran. Hätte ich das Repo so veröffentlicht, wäre der erste Fehler nach dem ersten Lauf auf mich zurückgefallen.

## Die Zahlen, die nicht stimmten

Im README standen „elf Compose-Stacks". Auf dem Server liefen:

- 15 Container
- in 5 Compose-Projekten
- plus ein Container, der per `docker run` gestartet war und in keinem Projekt auftauchte

Elf war keine Messung, sondern eine Erinnerung. Ich hatte die Dienste gezählt, die mir einfielen, nicht die, die liefen. Der Unterschied sind vier Container und ein fehlendes Projekt – genau die Sorte Lücke, die man bei einer Wiederherstellung merkt, wenn es zu spät ist.

Dasselbe bei den Ports. Im Architekturdiagramm stand Open WebUI auf 3000, SearXNG auf 8080, Homepage auf 3001\. Die Wirklichkeit:

```
$ ss -tlnp | grep 127.0.0.1
127.0.0.1:3000   homepage
127.0.0.1:8080   open-webui
127.0.0.1:8888   searxng

```

Drei von drei falsch. Nicht dramatisch – kein Angriff, kein Ausfall. Aber ein Diagramm, dem man nicht trauen kann, ist schlimmer als kein Diagramm.

## Der Fund, der wirklich weh tat

Beim Durchgehen der Compose-Dateien bin ich über eine Zeile gestolpert, die ich dort nicht erwartet hatte: ein SMTP-Passwort im Klartext, mitten in der Konfiguration.

Das Passwort war nicht in einem `.env`, nicht in einem Vault, sondern in einer Datei, die ich Monate vorher schnell erweitert hatte. Die Datei war mit `600` geschützt, also nur für root lesbar. Auf einem Einzelserver mit einem Admin-Account fühlt sich das sicher an.

Es ist trotzdem falsch, und zwar aus einem Grund, der nichts mit Angreifern zu tun hat: solche Dateien landen irgendwann in einem Backup, in einem Paste, in einem Repository. Ich habe das Passwort in die `.env` verschoben, die Compose-Datei auf eine Variable umgestellt und geprüft, dass der aufgelöste Wert byte-identisch ist – mit einem Vergleich der Längen und einem Hash, nicht mit „sieht gut aus".

Danach habe ich alle `.env`\-Dateien auf Rechte geprüft: alle `600`, alle `root:root`. Das war der einzige Punkt, an dem die Realität besser war als die Doku.

## Was daraus geworden ist

Zwölf Rollen, die den Server aus dem Nichts aufbauen:

- **base** – Pakete, Zeitzone, unattended-upgrades
- **tailscale** – Tailnet-Beitritt, Authkey aus dem Vault
- **ssh** – sshd auf Port 2222, key-only, kein root-Login, `AllowUsers admin`
- **ufw** – deny incoming, 80/443/8443 und die RustDesk-Ports öffentlich, 2222 ausschließlich auf `tailscale0`
- **fail2ban** – Jail für sshd, systemd-Backend
- **docker** – Engine, Compose-Plugin, Log-Rotation, `live-restore`
- **stack\_kisium**, **stack\_homeserver**, **stack\_homepage**, **stack\_homeassistant**, **stack\_kisium\_tv** – die fünf Compose-Projekte als Templates
- **stack\_rustdesk** – kam später dazu, als das Relay vom Testserver hierher umzog

Die Reihenfolge ist nicht alphabetisch, sondern technisch: Tailscale kommt vor SSH und ufw, sonst gibt es nach dem Umschalten keinen zweiten Weg auf den Host. Der kisium-Stack kommt vor dem homeserver-Stack, weil der sich an das Netz `kisium-net` anhängt, das der erste erzeugt.

Alle Passwörter laufen über `vault_`\-Variablen aus einer Datei, die per `.gitignore` ausgeschlossen und mit `ansible-vault` verschlüsselt ist. Im Repository steht kein einziges echtes Passwort, keine echte Domain, keine echte IP – das habe ich mit einem eigenen Audit-Skript geprüft, nicht per Augenmaß.

## Die Fehler beim Bauen

Zwei Dinge sind mir dabei passiert, und beide sind lehrreich.

**Der Healthcheck, der die DB blockierte.** Ich wollte `depends_on: condition: service_healthy` für Paperless einführen. Die Bedingung war schnell eingetragen – der zugehörige Healthcheck für die Datenbank landete durch einen Fehler in meinem Einfüge-Skript nicht in der Datei. Ergebnis: `docker compose up -d paperless` brach mit „dependency failed to start" ab. Kein laufender Dienst war betroffen, aber der nächste Deploy hätte nicht funktioniert. Gefunden habe ich es, weil ich nach jeder Änderung `docker compose config -q` laufen ließ und danach den Stack wirklich startete.

**Das Netzwerk, das beim Neustart verschwand.** n8n hing an zwei Netzen: dem Standardnetz und `kisium-net`, weil Workflows auf die Ghost-Datenbank zugreifen. Die zweite Verbindung war irgendwann von Hand mit `docker network connect` gesetzt worden. Nach einem `docker compose up -d n8n` war sie weg – Compose setzt die Netze auf das zurück, was in der Datei steht. n8n hätte MySQL nicht mehr gefunden, und ein Workflow wäre nicht mit einem Fehler stehengeblieben, sondern in einen Timeout gelaufen.

Beides ist heute deklarativ in der Compose-Datei. Und ich prüfe nach jedem Neustart mit `docker inspect`, welche Netze ein Container wirklich hat – nicht, welche er haben sollte.

## Was bewusst nicht im Repository ist

Die Backup-Skripte und der Health-Check liegen auf dem Server, nicht im Repo. Das ist eine Entscheidung, keine Vergesslichkeit: sie enthalten host-spezifische Pfade und sind gewachsen, nicht entworfen. Sie in Rollen zu pressen, hätte mehr Risiko erzeugt als Nutzen.

Was ich stattdessen gemacht habe: ein Tagesbackup für die Dienste, die vorher keins hatten (n8n und Home Assistant), ein stündlicher Check auf Zertifikatslaufzeiten, Container-Health und Disk-Auslastung, und ein Offsite-Ziel, das vorbereitet ist, aber noch auf ein Repository wartet.

Der ehrliche Stand: Solange das Offsite-Ziel nicht konfiguriert ist, liegen alle Backups auf derselben Platte. Stirbt die, sind sie weg. Das steht so im README unter „bewusste Einschränkungen" – nicht in einer Fußnote.

## Was ich daraus mitnehme

**Dokumentation ist ein Test.** Solange ich etwas nur aufschreibe, prüft es niemand. Sobald ich es in eine ausführbare Datei schreibe, prüft es der Linter, der Syntax-Check, der nächste Lauf. Acht von zehn Abweichungen in meinem Repo hat nicht die Recherche gefunden, sondern der Vergleich zwischen Datei und Server.

**Wer nur die Dienste zählt, die ihm einfallen, zählt falsch.** Die Zahl im README war eine Erinnerung. Die Zahl im Terminal war eine Messung. Ich habe aufgehört, aus dem Kopf zu dokumentieren.

**Fehler, die niemanden stören, bleiben am längsten.** Das Klartext-Passwort hat nie einen Ausfall verursacht. Die falschen Ports auch nicht. Das ist der Grund, warum sie monatelang da waren.

Die Kurzfassung mit allen Zahlen steht hier: [356 Sekunden und drei Fehler, die nur ein Kaltstart findet](https://kisium.de/ansible-356-sekunden/).

Das Repository ist veröffentlicht: [github.com/tobias-peine/vps-provisioning](https://github.com/tobias-peine/vps-provisioning?ref=kisium.de).

Vorher lief das Audit über die Historie (gitleaks: keine Funde), die Lizenz steht auf meinem Namen, und die Commit-Adresse ist die GitHub-Noreply-Adresse – damit meine private Mailadresse nicht in jedem Commit steht. Die CI läuft bei jedem Push: ansible-lint im production-Profil, yamllint, shellcheck.