Handbuch zur TYPO3-Appliance
Alles zum Betrieb der Appliance: Vorbereitung für SONIA, Installation, Sprachen, Suche, Keycloak-Client, Anmeldung über Keycloak, Backup und der Weg in die Produktion.
Was ist die Appliance?
Die Appliance ist ein fertiges Docker-Setup für TYPO3 14.3 LTS als Composer-Installation. TYPO3 läuft auf PHP 8.4-FPM hinter nginx 1.30, die Daten liegen in MariaDB 11.8 LTS, die Volltextsuche übernimmt Elasticsearch 9.5. Die Anmeldung im Backend erfolgt über Keycloak (OpenID Connect), die Website ist zweisprachig.
Fünf Container arbeiten zusammen:
| Service | Aufgabe |
|---|---|
web | nginx: liefert statische Dateien aus und leitet PHP-Anfragen an php weiter |
php | TYPO3 auf PHP-FPM, installiert TYPO3 beim ersten Start automatisch |
db | MariaDB 11.8 |
elasticsearch | Suchindex des Frontends, nur im internen Docker-Netz erreichbar |
scheduler | führt jede Minute typo3 scheduler:run aus, alle 15 Minuten zusätzlich typo3 search:index |
Die folgenden Seiten beschreiben Einrichtung und Betrieb. Wie die Konfigurationsdateien im Einzelnen funktionieren, erklärt der Bereich „Konfigurationsdateien“.
- Vorbereitung SONIA Einmalig je Rechner: Hosts-Eintrag für id.dev.sonia.de und das Root-Zertifikat des Ostfalia-Rechenzentrums – für Linux (Debian/Ubuntu), macOS und Windows.
- Schnellstart und Aufbau Appliance starten, Projektaufbau, persistente Daten und das Installieren von Extensions.
- Sprachen und Startseite Deutsch als Standard, Englisch unter /en/, Backend-Sprache und das Sitepackage mit Sprachumschalter.
- Suche und Datenschutz Volltextsuche mit Elasticsearch: Suchfeld, Index, Aktualisierung, Ausfallverhalten – und warum die Website ohne CDN auskommt.
- Keycloak-Client einrichten Schritt für Schritt mit Screenshots: Client typo3-v14 im Realm sonia anlegen – Zugriff, Protokoll, Abmeldung, Client-Secret, Rollen, Mapper und Client Scopes.
- Anmeldung über Keycloak Backend-Login per OpenID Connect: Keycloak-Client, Rollen, Login-Seite, Single Logout und Back-Channel-Logout.
- Betrieb und Backup Nützliche Befehle, Backup und Wiederherstellung, selbstentpackendes Archiv und Zurücksetzen.
- Produktion Was vor dem Betrieb auf einem Server zu tun ist: Passwörter, Hostnamen, TLS und Ports.