Einleitung
Updates für TYPO3 sind sehr wichtig. Sie sorgen für Sicherheit und Stabilität. Aber Updates kosten viel Zeit. Und Menschen machen dabei oft Fehler. Das gilt besonders bei vielen Webseiten. Unser TYPO3 Updater macht diesen Prozess automatisch. Er prüft die Webseiten. Er macht das Update. Er testet das Aussehen. Und er schreibt alles auf.
Dieses Programm ist für Agenturen. Es ist auch für IT-Abteilungen. Diese Gruppen betreuen oft viele TYPO3-Webseiten. Sie wollen die Updates gut und sicher machen. Sie wollen auch später noch wissen: Was genau ist beim Update passiert?
Inhaltsverzeichnis
Praxis-Szenarien
Security Update, Extension-Rollout, QA
Technische Anforderungen
System-Voraussetzungen, Installation
Best Practices
Update-Strategie, Wartung
Zusammenfassung
Kernvorteile, Zielgruppe
Warum TYPO3 Updater?
Typische Herausforderungen
Für Agenturen mit vielen TYPO3-Projekten:
- Updates von Hand kosten viel Zeit. Bei mehr als 20 Projekten dauert das Tage. Das gilt schon für kleine Updates (Minor-Release).
- Oft schreiben Entwickler die Arbeit nicht genau auf. Dann weiß später niemand, was passiert ist.
- Oft testet niemand das genaue Aussehen. Dann übersieht man Fehler im Layout.
- Menschen vergessen oft das Aufschreiben der Arbeitszeit. Sie vergessen auch oft das Anlegen von Tickets.
Für IT-Abteilungen:
- Sicherheits-Updates müssen schnell passieren. Das muss auf allen Webseiten gleichzeitig sein.
- Updates für Zusatz-Programme brauchen einen guten Plan. Ein Zusatz-Programm ist eine Extension (zum Beispiel Powermail).
- Bestimmte Regeln verlangen genaue Berichte. Das nennt man Compliance.
- Die Qualitäts-Kontrolle muss immer gleich ablaufen. Man muss die Kontrolle auch beweisen können.
Die Lösung
Der TYPO3 Updater macht alle Update-Schritte automatisch:
Zentrale Verwaltung
Das Programm erkennt alle DDEV-Projekte automatisch. Es sortiert die Projekte nach Alter. Es sortiert nach der TYPO3-Art. Und es sortiert nach den Server-Einstellungen.
Qualitäts-Kontrolle
Das Programm macht Bildschirm-Fotos zum Testen. Das passiert vor und nach dem Update. So sehen Sie Fehler im Aussehen sofort.
Genaue Berichte
Jedes Update macht automatisch ein Ticket in Redmine. Dort stehen alle Test-Ergebnisse. Sie sehen dort die Vergleiche der Fotos. Das Programm trägt auch die Arbeitszeit ein.
Architektur und Funktionsweise
Technische Grundlagen
Der TYPO3 Updater ist gut aufgebaut. Er verbindet bekannte Programme und moderne Technik:
Wichtige Programme:
- DDEV für die Arbeit am eigenen Computer. DDEV ist eine Entwicklungs-Umgebung.
- Deployer für das Übertragen der Daten. Das Übertragen heißt Deployment. Die Datei
.hosts.yamlbestimmt den Ziel-Server. - Composer für die Updates. Er aktualisiert den TYPO3 Core. Er aktualisiert auch die Extensions.
- Playwright für die Tests vom Aussehen. Es macht die Bildschirm-Fotos.
- Next.js für die Anzeige im Browser. Es baut die Benutzer-Oberfläche.
TYPO3 Updater Ablauf: Vom Erkennen bis zum Bericht
Automatische Projekt-Erkennung
Das Programm sucht in Ihrem Projekt-Ordner. Es wählt die Projekte schlau aus:
- DDEV-Projekte finden: Es sucht nach der Datei
.ddev/config.yaml. So findet es aktive DDEV-Projekte. - TYPO3 prüfen: Es liest die Datei
composer.json. Es sucht nachtypo3/cms-core. So prüft es die TYPO3-Installation. .hosts.yamlprüfen: Es schaut nach den Deployer-Einstellungen. Es prüft die Angaben für die Server.- Datum vom letzten Update prüfen: Es liest Daten aus Git und
composer.lock. So weiß es das Datum vom letzten Update.
Wichtig: Das Programm benutzt keine Künstliche Intelligenz (KI). Es arbeitet nach festen Regeln. Es liest Dateien und Einstellungen. Das ist sehr sicher und schnell.
Die Benutzeroberfläche
Dashboard: Projekt-Übersicht
Die Startseite zeigt alle TYPO3-Webseiten. Sie sehen sofort alle möglichen Updates:

Funktionen der Startseite:
- Gutes Suchen: Sie können nach Projekt-Namen suchen. Sie können nach dem Update-Datum suchen. Oder nach der TYPO3-Version.
- Zeichen für den Status: Sie sehen den Status von Deployer. Sie sehen Informationen zu Git.
- Mehrere Projekte: Sie können viele Projekte gleichzeitig auswählen. Dann machen Sie alle Updates zusammen.
- Sortieren: Sie können Listen ordnen. Zum Beispiel nach Datum oder Namen.
Die Startseite ist sehr einfach und sauber. Das hilft Ihnen beim schnellen Arbeiten. Sie können gute Entscheidungen treffen.
Command-Generator: Maximale Kontrolle
Manche Menschen arbeiten lieber in der Kommando-Zeile (Shell). Dafür gibt es diesen Bereich:

Das Programm baut genaue Befehle für die Shell. Alle wichtigen Einstellungen sind dabei:
Mögliche Einstellungen:
| Einstellung | Beschreibung | Standard |
|---|---|---|
| --batch-mode | Updates für mehrere Projekte gleichzeitig | ✓ |
| --dry-run | Ein Test-Lauf ohne echte Updates | ✓ |
| --skip-upload | Keine Daten auf den Server laden | ✕ |
| --skip-redmine | Kein Ticket in Redmine erstellen | ✕ |
| --skip-visual-tests | Keine Bildschirm-Fotos machen | ✕ |
| --verbose-output | Sehr genaue Texte beim Ablauf zeigen | ✕ |
Sie können den gebauten Befehl einfach kopieren. Dann fügen Sie ihn im Terminal ein. Das ist gut für automatische Arbeits-Abläufe.
Konfiguration: Zentrale Einstellungsverwaltung
Sie stellen alles im Browser ein:
Klicken Sie auf das Bild für eine große Ansicht
Bereiche für die Einstellungen:
Jede Einstellung hat kleine Hilfe-Texte. Das Programm prüft Ihre Eingaben sofort.
Der Update-Prozess
1. Ausführung mit Live-Monitoring
Sie haben die Projekte ausgewählt. Nun startet das Update. Sie sehen genau, was gerade passiert:

Ablauf in Schritten:
Environment Setup
Pre-Update Tests
Composer Updates
Post-Update Tests
Dokumentation
Status-Zeichen:
- 🟢 [SUCCESS]: Schritt ist fertig und ohne Fehler.
- 🟡 [WARNING]: Es gibt eine Warnung. Das Programm läuft aber weiter.
- 🔴 [ERROR]: Es gibt einen schweren Fehler. Das Programm bricht ab.
- 🔵 [INFO]: Das ist eine reine Information.
2. Visual Comparison Report
Nach dem Update gibt es einen genauen Bericht:

Inhalte im Bericht:
Gleiche Bilder
Diese Seiten haben sich nicht verändert. Das ist ein gutes Zeichen.
Unterschiede im Bild
Hier gibt es Änderungen im Aussehen. Das Programm markiert die Änderungen farbig.
Fehler bei Bildern
Hier hat der Test nicht funktioniert. Die Seite hat vielleicht zu lange geladen. Sie müssen das von Hand prüfen.
Besuchte Seiten
So viele Seiten hat das Programm getestet. Sie können die Anzahl einstellen.
Das Programm speichert den Bericht in einem geheimen Ordner. Niemand kann den Namen erraten. Der Link zum Bericht steht im Redmine-Ticket.
3. Redmine-Integration
Das Programm macht automatisch Tickets. Darin steht alles Wichtige:

Aufbau vom Ticket:
# TYPO3 UPDATE - [Projekt-Name]
## Art vom Ticket
Kleines Update (Automatisch gemacht)
## Projekt
[Projekt-ID]
## Webseite
https://www.beispiel-projekt.at
## Status
Das TYPO3 Update ist fertig. Version 12.4.36 ist jetzt 12.4.37.
Es gibt einen genauen Bericht zu den Tests.
Der Test-Bericht im Ticket:
- Vergleich der Bildschirm-Fotos (Vorher und Nachher)
- Tests der Funktionen
- Messung der Geschwindigkeit (Lighthouse Score)
- Bericht zur Sicherheit (Composer Audit Report)
- Tipps für die nächsten Schritte
Automatische Berichte:
- Alle Teile vom TYPO3 Core sind neu.
- Die Extensions passen zur neuen Version.
- Die Datenbank ist geprüft.
- Der Zwischen-Speicher (Cache) ist leer und neu.
- Die Einstellungs-Dateien sind geprüft.
Composer Audit Report
Ein wichtiger Teil ist die Prüfung der Sicherheit. Das macht der Composer Audit Report:
Prüfung der Sicherheit:
- Keine Sicherheits-Lücken gefunden
- Keine Fehler-Pakete gefunden
- Der ganze Bericht steht im Ticket
Nächste Schritte:
- Prüfen Sie die Funktionen der Webseite.
- Beobachten Sie die Geschwindigkeit.
- Schreiben Sie weitere Änderungen auf.
Praxis-Szenarien
Szenario 1: Security Update für alle Instanzen
Die Lage: Es gibt ein wichtiges Sicherheits-Update von TYPO3.
Die Lösung mit dem Programm:
Meldung zur Sicherheit bekommen
Projekte auswählen
Update starten
Ende und Berichte
Gesparte Zeit: Von Hand dauert das 2 bis 3 Tage. Mit dem Programm dauert es 2,5 Stunden.
Szenario 2: Extension-Rollout über alle Projekte
Die Lage: Es gibt ein Powermail-Update. Es soll auf alle Webseiten.
Der Ablauf:
- Einstellungen ändern: Sie tragen
in2code/powermail:*in die Einstellungen ein. - Projekte filtern: Sie wählen nur Projekte mit Powermail aus.
- Langsamer Start: Sie testen das Update auf 3 Webseiten. Wenn alles klappt, updaten Sie den Rest.
- Berichte: Jede Webseite bekommt ein Ticket. Dort stehen die Änderungen und die Tests.
Szenario 3: Qualitätsgesicherte Updates
Die Lage: Die IT-Abteilung braucht Beweise für gute Qualität. Die Regeln verlangen das.
Das liefert das Programm:
- Gleiche Tests: Jedes Update durchläuft genau die gleichen Tests.
- Bilder als Beweis: Es gibt Vorher-Nachher-Bilder als Beweis.
- Genaue Zeiten: Das Programm speichert die genaue Uhrzeit. Sie können alles genau nachprüfen.
- Tickets: Es gibt vollständige Berichte in Redmine.
- Sichere Passwörter: Das Programm speichert Zugangs-Daten (SSH-Keys) sehr sicher.
Das Programm braucht SSH-Keys für den Server. Das Programm speichert diese Keys sehr sicher. Fehlt ein Key? Dann stoppt das Programm. Es zeigt einen Fehler an. Das ist sehr sicher.
Technische Anforderungen
System-Voraussetzungen
Für den Server:
- DDEV ist da und eingestellt.
- Node.js Version 18 oder höher (für die Oberfläche).
- Composer Version 2.x ist da.
- Es gibt einen SSH-Zugang zu den Servern.
Zusätzlich für mehr Funktionen:
- Redmine mit API-Zugang.
- Deployer-Einstellungen in der Datei
.hosts.yaml. - Playwright für die Bild-Tests.
Installation
# Repository laden
git clone https://github.com/your-org/typo3-updater.git
cd typo3-updater
# Programme installieren
npm install
cd test/playwright && npm install
# Einstellungen erstellen
cp .env.example .env
# Oberfläche starten
npm run dev
# Browser öffnenDie Oberfläche ist dann unter http://localhost:3000 erreichbar.
Best Practices
Update-Strategie
| Feature | Empfohlen | Nicht empfohlen |
|---|---|---|
| Langsames Ausrollen | ✓ | ✕ |
| Erst ein Test-Lauf | ✓ | ✕ |
| Bild-Tests einschalten | ✓ | ✕ |
| Alle Webseiten gleichzeitig | ✕ | ✓ |
| Updates ohne Tests | ✕ | ✓ |
| Berichte von Hand schreiben | ✕ | ✓ |
Wartung und Monitoring
Regelmäßige Aufgaben:
- Bilder löschen: Alte Bilder löschen (geht automatisch nach 30 Tagen).
- Passwörter ändern: API-Keys alle 90 Tage neu machen.
- Protokolle lesen: Warnungen im Protokoll prüfen.
- SSH-Keys ändern: Wenn Personen das Team verlassen.
Für schnelles Arbeiten:
- Bild-Tests gleichzeitig machen (maximal 3 Browser).
- Bilder nicht zu groß machen (nur 1920x1080 Pixel).
- Alte Berichte automatisch wegräumen.
- DDEV nach dem Update neu starten.
Geld sparen und Gewinn
Zeit- und Kostenanalyse
| Aufgabe | Handarbeit | Automatisch | Gespart |
|---|---|---|---|
| Ein TYPO3 Update | 45 min | 5 min | -89% |
| Bild-Tests | 30 min | 2 min | -93% |
| Berichte schreiben | 20 min | 1 min | -95% |
| Ticket in Redmine | 15 min | 0 min | -100% |
| Alles zusammen pro Update | 110 min | 8 min | -93% |
Visualisierung der Zeitersparnis
Zeit für jeden Update-Schritt in Minuten
Beispiel für eine Agentur mit 20 Projekten:
- 8 kleine Updates für TYPO3 im Jahr.
- 9 wichtige Updates für Extensions im Jahr.
- Das sind 17 Updates für 20 Projekte. Das sind 340 Updates im Jahr.
- Arbeit von Hand: 340 mal 110 Minuten sind 623 Stunden.
- Mit dem Programm: 340 mal 8 Minuten sind 45 Stunden.
- Gesparte Zeit: 578 Stunden im Jahr.
Bei einem Stunden-Lohn von 150 Euro:
- Gespartes Geld: 86.700 Euro im Jahr.
- Gewinn schon nach wenigen Wochen.
Skalierung: Kostenersparnis nach Projektanzahl
Kosten im Jahr in Euro. Mehr Projekte bedeuten mehr gespartes Geld.
Zeitverteilung: Manueller Update-Prozess
Wo geht die Zeit bei Handarbeit verloren? (110 Minuten zusammen)
ROI-Entwicklung über 12 Monate
Die Kosten sind nach 3 bis 4 Wochen bezahlt. Danach sparen Sie nur noch Geld.
Sie sparen Zeit. Sie machen auch weniger Fehler. Die Tests sind immer gleich gut. Sie haben perfekte Berichte für Kunden und Regeln.
Zusammenfassung
Der TYPO3 Updater ist ein sehr gutes Programm. Es ist eine große Hilfe für professionelle TYPO3-Webseiten:
Wichtigste Vorteile:
Schnell arbeiten
Sie sparen 93 Prozent der Zeit. Das Programm macht die langweiligen Aufgaben.
Gute Qualität
Die Bild-Tests prüfen das Aussehen. Nach dem Update sieht alles richtig aus.
Alles klar
Sie haben genaue Berichte in Redmine. Sie haben Bilder und Tests.
Sicherheit
Das Programm speichert Zugangs-Daten sicher. Es macht sichere Tests.
Wachsen
Sie können viele Projekte gleichzeitig aktualisieren. Die Qualität bleibt immer gleich gut.
Gute Kontrolle
Sie können Test-Läufe machen. Sie können Updates langsam ausrollen.
Für wen ist das Programm gut?
Sehr gut für:
- Agenturen mit mehr als 5 TYPO3-Projekten.
- IT-Abteilungen mit vielen Webseiten.
- Firmen für das Hosting von Webseiten.
- Teams für den Server-Betrieb (DevOps).
Technisches Wissen:
-
Sie kennen DDEV und Composer.
-
Sie kennen einfache Shell-Befehle.
-
Freiwillig: Sie kennen Deployer.
-
Freiwillig: Sie haben Admin-Rechte in Redmine.
-
Wir können Ihr Team schulen.
-
Wir können das Programm für Sie betreiben.
Wir haben diesen Text am 2025-10-04 geschrieben. Wir verbessern das Programm ständig. Funktionen und Bilder können sich später ändern.
