RTFM: Technische Wissensdatenbank
Ein WordPress-Blog für Fehlerbilder aus Betrieb und Sicherheit, mit eigenem Theme im Design von disisto.de, Artikeln in Markdown, Login über Keycloak und einem Frontend, das nur Inhalte vom eigenen Server lädt.
Seit
2025
Umfang
Theme, Plugins, Login und Betrieb
Technologien
Die Herausforderung
Lösungen für Fehler aus dem Betrieb landen sonst in Notizen, Tickets oder Chatverläufen und sind beim nächsten Mal nicht auffindbar. Eine öffentliche Wissensdatenbank muss dabei so gehärtet sein wie die Systeme, über die sie schreibt, und darf Leser nicht an Dritte weiterreichen.
Die Lösung
WordPress als Redaktionssystem, aber mit eigenem Theme, eigenen Plugins und einer Auslieferung, die nur den eigenen Server kennt. Artikel entstehen in Markdown, die Anmeldung läuft über den zentralen Keycloak, und nginx setzt für jeden Bereich eine eigene Content Security Policy.
Aufbau
Eigenes Theme
Farben, Verläufe und Komponenten folgen disisto.de. Hell und dunkel lassen sich umschalten, die Startseite zeigt Themen, beliebte Artikel und eine Suche. Wechselnde Sprüche im Kopfbereich pflegt ein eigenes Plugin nach Kategorien.
Schreiben in Markdown
Artikel entstehen in Markdown statt im Block-Editor, mit Tabellen, Codeblöcken und Inline-Code. Fehlerbilder lassen sich so mit Logzeilen, Befehlen und Zeitstempeln genau nachstellen.
Gehärtete Auslieferung
nginx vor PHP-FPM, WordPress-Objekte im Redis-Cache. Das Frontend erlaubt Skripte und Styles nur vom eigenen Server, Uploads werden ohne ausführbare Inhalte ausgeliefert, und PHP verrät weder Version noch Standard-Session-Namen.
Login über Keycloak
Redakteure melden sich über OpenID Connect am zentralen Keycloak an, mit dem selbst entwickelten Plugin Simple OIDC SSO. Benutzerkonten werden bei der Anmeldung abgeglichen, ein eigenes WordPress-Passwort ist für den Alltag nicht nötig.
Themen
Sicherheit, Linux und Systemadministration, Netzwerk, Docker und Container, Monitoring und Observability, Audio sowie KI- und Entwicklungswerkzeuge. Jeder Artikel geht von einem konkreten Fehlerbild aus und endet mit einer nachvollziehbaren Lösung.
Betrieb
rtfm läuft in eigenen Docker-Containern für WordPress, Datenbank, Cache und nginx und ist nur über den vorgelagerten Reverse Proxy erreichbar. Images werden mit den Paketständen des Bautags gebaut, Änderungen an Theme und Konfiguration liegen versioniert in Git.
Datenschutz
Die Seiten laden nichts von Dritten. Statistik misst selbst gehostetes Matomo serverseitig und erst nach Einwilligung; wer nur das Nötige zulässt, wird nicht gezählt.
Ergebnisse
Eine Wissensdatenbank, die selbst nach den Regeln arbeitet, über die sie schreibt: gehärtet, ohne Abhängigkeit von fremden Diensten und mit einem Login, der an die übrige Infrastruktur angebunden ist.
Galerie
Screenshots von rtfm.disisto.de.