Die TYPO3 Console ist ein Composer Paket von Helmut Hummel, besser bekannt als Helhum. Sie holt Aufgaben aus dem TYPO3 Backend auf die Kommandozeile: Datenbank Schema aktualisieren, Backend sperren, Caches gezielt leeren, Datenbank exportieren. Damit wird ein TYPO3 Deployment zu einem Skript, das jedes Mal gleich läuft.
Deployments, die jedes Mal gleich laufen: Wir bauen mit euch CI/CD Pipelines mit Quality Gates, E2E Tests und Deployments auf Servern in Deutschland. Zum CI/CD Pipeline Setup
Was ist die TYPO3 Console?
Viele Aufgaben in TYPO3 liefen früher nur über das Backend oder das Install Tool. Für Automatisierung ist das schlecht. Ein Klick im Browser lässt sich nicht in eine Pipeline schreiben. Die TYPO3 Console schließt diese Lücke. Sie bringt Commands für Entwicklung, Deployment, Docker Setups und CI mit.
Das Paket heißt helhum/typo3-console und ist eines der meistgenutzten im TYPO3 Umfeld. Auf Packagist stehen fast zehn Millionen Installationen. Der Code liegt heute in der Organisation TYPO3-Console auf GitHub.
Wie funktioniert die TYPO3 Console technisch?
Die Basis ist die Symfony Console Komponente. Wer bin/console aus Symfony kennt, findet sich sofort zurecht. Jeder Command ist eine Klasse mit Name, Argumenten und Optionen. Hilfe gibt es mit --help, Rückfragen schaltet ihr mit --no-interaction ab.
Die Console registriert ihre Commands im offiziellen TYPO3 CLI. Ihr ruft also kein eigenes Programm auf, sondern vendor/bin/typo3. Ein Detail macht sie besonders: Nicht jeder Command braucht einen voll gestarteten TYPO3 Kern. Deshalb funktionieren manche Commands auch, wenn die Installation noch gar nicht eingerichtet ist.
Installation und Versionen 2026
Ihr installiert die Console per Composer im Projekt:
composer require helhum/typo3-consoleDie aktuelle Major Version 9 unterstützt laut Packagist diese Kombinationen:
| Bereich | Unterstützt in Version 9 |
|---|---|
| TYPO3 | 12.4, 13 und 14.3 |
| PHP | ab 8.2 |
| Symfony Console | 5.4, 6.4 und 7 |
| CLI Aufruf | vendor/bin/typo3 |
Wer gerade auf TYPO3 14 umsteigt, kann die Console also mitnehmen. Was beim Sprung auf 14 sonst wichtig ist, steht in unserem TYPO3 14 Upgrade Guide.
Achtung: typo3cms gibt es nicht mehr
Viele alte Tutorials zeigen noch das Binary typo3cms. Das wurde mit Version 8.0.0 entfernt. Alle Commands laufen seitdem über das TYPO3 Core Binary typo3. Aus einem alten Aufruf wird also:
# alt, bis Version 7
vendor/bin/typo3cms database:updateschema
# neu, ab Version 8
vendor/bin/typo3 database:updateschemaPrüft beim Update eure Deploy Skripte, Composer Scripts und CI Jobs. Ein vergessener typo3cms Aufruf bricht sonst das nächste Deployment ab.
Die wichtigsten Commands im Überblick
Ein Teil der früheren Console Commands ist inzwischen im TYPO3 Kern gelandet, etwa cache:flush oder extension:setup. Die Console bringt vor allem diese Commands zusätzlich mit:
- install:setup: richtet eine neue TYPO3 Instanz komplett per CLI ein, interaktiv oder ohne Rückfragen.
- database:updateschema: aktualisiert das Datenbank Schema granular, zum Beispiel nur Tabellen hinzufügen und ändern.
- database:export und database:import: Datenbank sichern und einspielen, Cache Tabellen lassen sich ausschließen.
- backend:lockforeditors: sperrt das Backend für Redakteure, Admins und CLI arbeiten weiter.
- cache:flushtags: leert nur Caches mit bestimmten Tags statt alles.
- configuration:showactive: zeigt die aktive Konfiguration, auf Wunsch als JSON.
Die vollständige Liste steht in der Command Reference der TYPO3 Console. Neue CLI Features direkt im Kern zeigt unser Beitrag zu TYPO3 14 CLI Kommandos.
Ein Deployment Ablauf mit der TYPO3 Console
So sieht ein typischer Ablauf nach dem Ausrollen des Codes aus. Er kombiniert Console Commands mit Commands aus dem TYPO3 Kern:
# Sicherung vor dem Update, ohne Cache Tabellen
vendor/bin/typo3 database:export -e 'cache_*' > backup.sql
# Redakteure kurz aussperren
vendor/bin/typo3 backend:lockforeditors
# Schema anpassen, ohne etwas zu löschen
vendor/bin/typo3 database:updateschema "*.add,*.change" --no-interaction
# Extensions einrichten und Upgrade Wizards ausführen (TYPO3 Kern)
vendor/bin/typo3 extension:setup
vendor/bin/typo3 upgrade:run --no-interaction
# Caches leeren und Backend wieder freigeben
vendor/bin/typo3 cache:flush
vendor/bin/typo3 backend:unlockforeditorsDer Vorteil: Jeder Schritt ist sichtbar, versioniert und wiederholbar. Niemand muss sich nach dem Deployment ins Install Tool einloggen. Mit "*.add,*.change" bleiben Löschungen im Schema bewusst außen vor. Die macht ihr besser in einem eigenen, geprüften Schritt.
TYPO3 Console in CI und Docker
In GitHub Actions oder GitLab CI läuft der gleiche Ablauf als Job. Wichtig ist --no-interaction, damit kein Command auf eine Eingabe wartet. In Docker Setups hilft install:setup, um eine frische Instanz für Tests ohne Klicks hochzuziehen.
Ein Deployment ist aber erst fertig, wenn die Seite wirklich funktioniert. Deshalb gehören nach den Console Commands Smoke Tests in die Pipeline. Wir setzen dafür Cypress ein, wie in der Cypress Schulung für Teams gezeigt. Für Extensions selbst lohnt sich das TYPO3 Testing Framework mit PHPUnit. Wie die Reihenfolge in einer guten Pipeline aussieht, beschreibt Quality Gates in der Pipeline. Und wenn die Pipeline zu teuer wird, hilft CI Rechnung explodiert? weiter.
Fazit
Die TYPO3 Console macht aus Klicks im Backend wiederholbare Commands. Sie baut auf Symfony Console auf, läuft über das Core Binary typo3 und unterstützt in Version 9 auch TYPO3 14. Wer noch Skripte mit typo3cms hat, sollte sie jetzt umstellen. Danach gehört die Console in jedes TYPO3 Deployment, das ohne Handarbeit laufen soll.
Häufige Fragen zur TYPO3 Console
Unterstützt die TYPO3 Console 2026 schon TYPO3 14?
Ja. Version 9 der TYPO3 Console unterstützt laut Packagist TYPO3 12.4, 13 und 14.3. Voraussetzung ist PHP ab Version 8.2. Ihr könnt die Console also beim Upgrade auf TYPO3 14 weiter nutzen.
Wie installiere ich die TYPO3 Console 2026?
Per Composer mit composer require helhum/typo3-console. Die Commands stehen danach über vendor/bin/typo3 bereit. Eine Liste aller verfügbaren Commands zeigt vendor/bin/typo3 list.
Warum funktioniert typo3cms 2026 nicht mehr?
Das Binary typo3cms wurde mit Version 8.0.0 der TYPO3 Console entfernt. Alle Commands laufen seitdem über das TYPO3 Core Binary typo3. Ihr müsst in Skripten nur den Aufruf ändern, der Command Name bleibt gleich.
Brauche ich die TYPO3 Console 2026 noch, wenn der Kern ein CLI hat?
Für viele Projekte ja. Der Kern hat einige Commands übernommen, etwa cache:flush. Die Console bringt aber weitere mit, zum Beispiel granulare Schema Updates, Datenbank Export und Import sowie das Sperren des Backends für Redakteure.
Wie nutze ich die TYPO3 Console 2026 in einer CI Pipeline?
Ihr ruft die Commands als Schritte im Deploy Job auf, immer mit --no-interaction. Typisch sind Schema Update, Extension Setup, Upgrade Wizards und Cache leeren. Danach sollten Smoke Tests prüfen, ob die Seite wirklich läuft.
Wer entwickelt die TYPO3 Console?
Gestartet hat sie Helmut Hummel, in der Community als Helhum bekannt. Heute entwickeln er und weitere Contributors das Projekt in der GitHub Organisation TYPO3-Console weiter. Es steht unter der Lizenz GPL 2.0 oder später.
Deployment ohne Handarbeit
Wir bauen mit euch eine Pipeline, die Schema Updates, Caches und Smoke Tests automatisch erledigt: GitLab CI oder GitHub Actions, Cypress E2E und Deployments auf Servern in Deutschland. Kennenlernen kostenlos.
