TYPO3-Update: Versions-Überblick, Upgrade-Pfade und Stolperfallen

Ein TYPO3-Update ist kein optionaler Luxus, sondern eine regelmäßig wiederkehrende Pflichtaufgabe. Jede TYPO3-Version hat ein definiertes End-of-Life-Datum, nach dem keine Sicherheitsupdates mehr erscheinen. Wer Updates aufschiebt, akkumuliert technische Schulden, Extension-Inkompatibilitäten und Sicherheitsrisiken. Dieser Leitfaden beschreibt die TYPO3-Versionshistorie, konkrete Upgrade-Pfade und die typischen Stolperfallen, die bei Major-Updates auftreten.
Ein junger, hipper Mann sitzt mit seinem Notebook im Café. Er blickt zur Seite und redet mit jemandem, während sein Typo3 Update läuft.
© BullRun

TYPO3-Versionen im Überblick

TYPO3 veröffentlicht seine Major-Versionen im Abstand von rund 18 Monaten, jede davon als LTS (Long-Term Support) mit etwa drei Jahren freiem Support. Danach ist kostenpflichtiger Extended LTS (ELTS) über die TYPO3 GmbH verfügbar.

VersionReleasePHP-AnforderungReguläres EOLELTS EOL
v8 LTSMärz 2017PHP 7.0 bis 7.2März 2020März 2023
v9 LTSOktober 2018PHP 7.2 bis 7.4Oktober 2021Oktober 2024
v10 LTSApril 2020PHP 7.2 bis 7.4April 2023April 2026
v11 LTSOktober 2021PHP 7.4 bis 8.2Oktober 2024Oktober 2027
v12 LTSApril 2023PHP 8.1 bis 8.3April 2026April 2029
v13 LTSOktober 2024PHP 8.2 bis 8.5Dezember 2027Dezember 2030
v14 LTSApril 2026PHP 8.2 bis 8.5Juni 2029Juni 2032

Was die Tabelle zeigt (Stand Juli 2026): Für TYPO3 v10 ist auch der ELTS-Zeitraum im April 2026 ausgelaufen, solche Installationen erhalten überhaupt keine Sicherheitsupdates mehr. TYPO3 v11 läuft seit Oktober 2024 nur noch im ELTS, TYPO3 v12 seit dem 30. April 2026. Ziel eines Updates ist damit v13 LTS (freier Support bis Ende 2027) oder direkt v14 LTS (bis Juni 2029).

Warum TYPO3-Updates nicht optional sind

Das Aufschieben von TYPO3-Updates ist eine der häufigsten Ursachen für explodierende IT-Kosten im CMS-Betrieb. Die Gründe, warum Updates unvermeidlich sind:

Sicherheitsrisiken: Nach dem End-of-Life erscheinen keine Sicherheitsupdates mehr (außer über das kostenpflichtige ELTS-Programm). Bekannte Schwachstellen bleiben offen, ein Einfallstor für Angreifer. Für Behörden und regulierte Unternehmen ist der Betrieb einer nicht gepatchten CMS-Version ein Compliance-Verstoß.

PHP-Kompatibilität: TYPO3 v10 unterstützt maximal PHP 7.4, eine Version, die seit November 2022 kein Security-Support mehr erhält. Der Betrieb einer aktuellen PHP-Version erfordert ein aktuelles TYPO3. Umgekehrt erzwingt ein PHP-Upgrade häufig ein TYPO3-Update.

Extension-Support: Extension-Entwickler stellen den Support für ältere TYPO3-Versionen ein, sobald diese aus dem regulären Support fallen. Wer auf v10 bleibt, findet zunehmend Extensions, die nur noch v13 und v14 unterstützen. Die Auswahl schrumpft mit jedem Monat, in dem das Update aufgeschoben wird.

ELTS-Kosten vs. Update-Kosten: ELTS kostet pro Installation und Jahr. Über drei Jahre ELTS-Laufzeit summieren sich die Lizenzkosten, oft auf einen Betrag, der die einmaligen Update-Kosten übersteigt. ELTS ist als Überbrückung gedacht, nicht als Dauerlösung.

Entwicklermarkt: TYPO3-Entwickler, die noch Erfahrung mit v8 oder v9 haben, werden seltener. Ein System auf einer veralteten Version zu betreiben bedeutet, den Pool potenzieller Wartungspartner zu verkleinern.

Performance-Einbußen: Neuere TYPO3-Versionen profitieren von PHP-8.x-Optimierungen (JIT-Compiler, verbesserte Opcache-Nutzung, Union Types) und Core-internen Performance-Verbesserungen. Ein TYPO3 v13 auf PHP 8.3 ist messbar schneller als ein TYPO3 v10 auf PHP 7.4, bei gleicher Hardware und gleichem Datenvolumen. Für Websites mit hohem Traffic summieren sich diese Unterschiede zu spürbaren Einsparungen bei Serverressourcen.

Funktionale Rückstände: Jede TYPO3-Version bringt neue Funktionen, die Redakteuren und Entwicklern die Arbeit erleichtern. TYPO3 v12 führte die verbesserte Benutzerverwaltung, das Site-Sets-Konzept und native Content-Block-Registrierung ein. TYPO3 v13 brachte Verbesserungen im Asset-Handling, der Backend-Performance und der Accessibility des Backends. Wer auf v10 verbleibt, verzichtet auf vier Jahre funktionaler Weiterentwicklung.

Update-Pfad: Von TYPO3 v11/v12 auf v14

Ein TYPO3 Major-Update ist kein einzelner Klick, sondern ein strukturiertes Projekt. Der empfohlene Pfad für ein Update von v11 oder v12 auf v14:

Schritt 1: Extension-Audit

Vor dem Update steht eine vollständige Bestandsaufnahme aller installierten Extensions:

Für jede Extension, die nicht kompatibel ist, gibt es drei Optionen: (1) Update auf eine kompatible Version, (2) Ersatz durch eine alternative Extension, (3) Eigenentwicklung eines Ersatzes.

Schritt 2: PHP-Kompatibilität sicherstellen

TYPO3 v13 und v14 erfordern mindestens PHP 8.2 und unterstützen bis PHP 8.5. Wenn das aktuelle System auf PHP 7.4 läuft, muss die PHP-Version schrittweise aktualisiert werden, idealerweise vor dem TYPO3-Update, um PHP-spezifische Fehler isoliert behandeln zu können.

Relevant sind:

Schritt 3: Deprecations bereinigen

Jede TYPO3-Version markiert APIs und Konfigurationsoptionen als deprecated, die in der nächsten Major-Version entfernt werden. TYPO3 bietet dafür ein Deprecation Log im Backend (unter Admin Tools → Upgrade):

Es empfiehlt sich, Deprecations in der aktuellen Version zu bereinigen, bevor das Major-Update durchgeführt wird. So lassen sich Update-Probleme und Deprecation-Probleme getrennt debuggen.

Schritt 4: Upgrade Wizard ausführen

Nach der Aktualisierung der Composer-Abhängigkeiten auf die Zielversion führt der TYPO3 Upgrade Wizard die nötigen Datenbank-Migrationen und Konfigurationsanpassungen durch. Der Wizard ist über das Install Tool oder die CLI (vendor/bin/typo3 upgrade:run) erreichbar und verarbeitet unter anderem:

Jeder Wizard-Schritt lässt sich einzeln ausführen und verifizieren. Für automatisierte Deployments können Wizard-Schritte auch per CLI in der CI/CD-Pipeline ausgeführt werden.

Schritt 5: Testen

Nach dem Update-Durchlauf auf einer Staging-Umgebung folgt ein systematischer Testprozess:

Schritt 6: Deployment

Das Produktiv-Deployment erfolgt containerisiert mit Rollback-Option:

Extension-Kompatibilität prüfen

Die Extension-Kompatibilität ist der zeitintensivste Aspekt eines TYPO3-Updates. Für jede Extension im Projekt sollten folgende Quellen geprüft werden:

Packagist/Composer: composer show -a vendor/extension zeigt verfügbare Versionen und deren TYPO3-Kompatibilität. Ein composer why-not typo3/cms-core:^14 identifiziert Extensions, die das Update blockieren.

Extension-Dokumentation: Viele Extensions dokumentieren ihre Kompatibilitätsmatrix in der README oder auf docs.typo3.org.

GitHub/GitLab: Der Issue-Tracker und die Branches/Tags zeigen, ob aktiv an einer kompatiblen Version gearbeitet wird.

Alternativen für aufgegebene Extensions:

TYPO3 Upgrade Wizard und Install Tool

Der Upgrade Wizard ist das zentrale Werkzeug für Datenmigrationen zwischen TYPO3-Versionen. Jede Major-Version bringt eigene Wizard-Schritte mit:

TYPO3 v11 auf v12:

TYPO3 v12 auf v13:

Install Tool: Neben dem Upgrade Wizard bietet das Install Tool Funktionen für:

Typische Stolperfallen bei TYPO3-Updates

Aus der Praxis mit Dutzenden TYPO3-Updates lassen sich wiederkehrende Problemkategorien identifizieren:

Breaking Changes in der TCA-Konfiguration: Die Table Configuration Array (TCA) definiert, wie TYPO3 Datenbankfelder im Backend darstellt. Jede Major-Version ändert TCA-Optionen, entfernte Typen, umbenannte Konfigurationsschlüssel, geänderte Rendering-Widgets. Custom Extensions mit eigener TCA-Konfiguration müssen bei jedem Update geprüft und angepasst werden.

Entfernte PHP-APIs: TYPO3 markiert APIs eine Version lang als deprecated und entfernt sie in der nächsten Major-Version. Klassiker: $GLOBALS['TSFE']-Zugriffe, ObjectManager::get(), GeneralUtility::makeInstance() mit geänderten Signaturen. Das Deprecation Log (Admin Tools → Upgrade → Scan Extension Files) identifiziert betroffene Stellen.

TypoScript-Änderungen: TypoScript-Konfigurationen können zwischen Versionen inkompatibel werden. Besonders häufig: geänderte Standardwerte, entfernte Konfigurationsoptionen, Syntax-Verschärfungen. Ab TYPO3 v13 gelten strengere Parsing-Regeln, die Tippfehler, welche ältere Versionen toleriert haben, nun als Fehler melden.

Fluid-Template-Änderungen: Neue ViewHelper-Argumente, entfernte ViewHelper oder geänderte Ausgabeformate können bestehende Templates brechen. Besonders betroffen: Templates, die auf Core-ViewHelper mit undokumentierten Argumenten zugreifen.

FAL-Änderungen (File Abstraction Layer): Die Dateiverwaltung ändert sich subtil zwischen Versionen, neue Metadaten-Felder, geändertes Crop-Handling, angepasste Bildverarbeitungs-Konfigurationen. FAL-Probleme fallen oft erst auf, wenn Redakteure nach dem Update Bilder bearbeiten.

Scheduler-Tasks und CLI-Commands: TYPO3-Scheduler-Tasks und CLI-Commands ändern ihren Namespace oder ihre Registrierung zwischen Versionen. Automatisierte Prozesse (Cronjobs, CI/CD-Skripte), die TYPO3-CLI-Befehle aufrufen, müssen nach dem Update geprüft werden.

Backend-JavaScript: Ab TYPO3 v12 wurde jQuery als Abhängigkeit im Backend schrittweise entfernt und durch native ES6-Module und Lit-basierte Web Components ersetzt. Extensions, die eigenes Backend-JavaScript mit jQuery-Abhängigkeiten nutzen, müssen ihre Skripte modernisieren. Dieser Aspekt wird häufig übersehen, da er sich nicht in PHP-Deprecation-Logs zeigt, sondern erst im Browser-Testing auffällt.

Composer Mode als Standard: Ab TYPO3 v12 ist der Composer-basierte Installationsmodus der empfohlene Standard. Projekte, die noch im Classic Mode (ohne Composer) betrieben werden, sollten im Zuge eines Major-Updates auf Composer umgestellt werden. Die Umstellung selbst ist ein eigenständiges Migrationsprojekt, das die Verzeichnisstruktur, das Deployment und die Extension-Verwaltung grundlegend ändert.

TYPO3-Updates bei TenMedia

TenMedia führt TYPO3-Updates als strukturierte Projekte durch, mit definiertem Scope, Zeitplan und Qualitätssicherung.

Prozess:

Rollback-Strategie: Bei kritischen Problemen nach dem Produktiv-Update wird das vorherige Container-Image reaktiviert und die Datenbank aus dem Pre-Update-Backup wiederhergestellt. Die gesamte Rollback-Prozedur dauert unter 15 Minuten.

Enthaltene Leistungen im Wartungsvertrag: TYPO3 Patch-Level-Updates (z. B. von v13.4.30 auf v13.4.33) sind in den Wartungsverträgen von TenMedia enthalten. Major-Updates (z. B. von v12 auf v14) werden als separates Projekt kalkuliert, da der Aufwand je nach Extension-Landschaft und Template-Komplexität variiert.

Die übergeordnete Seite zur TYPO3-Entwicklung ordnet Updates in den Gesamtkontext des TYPO3-Lebenszyklus ein. Details zur laufenden Wartung stehen auf der Seite TYPO3-Wartung. Für Migrationen, die über ein reines Versions-Upgrade hinausgehen, bietet der Leitfaden TYPO3-Migration eine weiterführende Orientierung.

Weiterführende Informationen