TYPO3 mit Docker installieren - Schneller & zuverlässiger Einrichtungsleitfaden (2026 Ausgabe)

git clone https:// github.com/webdevops/TYPO3-docker-boilerplate.git my-typo3-project
cd my-typo3-project
cp docker-compose.development.yml docker-compose.yml
docker-compose up -d

Nachdem die Container gestartet sind:

• Platzieren oder verbinden Sie Ihr TYPO3-Projekt innerhalb des Anwendungsverzeichnisses, das vom Setup verwendet wird.
• Wählen Sie den richtigen Web-Stack, wie Nginx oder Apache, basierend auf Ihrer Hosting-Präferenz.
• Konfigurieren Sie die Datenbank, PHP-Version, Environment-Dateien und erforderliche Dienste.
• Aktivieren Sie optionale Dienste wie Redis, Solr oder Elasticsearch nur, wenn das Projekt sie benötigt.
• Testen Sie TYPO3 Backend, Frontend, Dateiverarbeitung und Datenbankverbindung, bevor Sie es in einem Team-Workflow verwenden.

WebDevOps ist nützlich für Agenturen und Enterprise-Teams, die Docker benötigen, um mehr als einfache lokale Entwicklung zu unterstützen. Für die Produktion sollten Sie Sicherheit, persistenten Speicher, Environment-Variablen, Backups und freigegebene Ports vor dem Deployment prüfen.

TYPO3 Docker Images verglichen

Verschiedene TYPO3 Docker Images dienen verschiedenen Zielen. Einige sind für schnelle lokale Entwicklung gebaut, während andere besser als Basis für strukturierte Team-Workflows oder produktionskontrollierte Setups funktionieren.

Für die meisten Entwickler ist DDEV die sicherste Wahl für lokale Entwicklung. Für Agenturen und größere Teams geben WebDevOps oder ein Individuelle Docker-Compose-Konfiguration mehr Kontrolle über Dienste und Environments.

Für produktionsorientierte TYPO3-Projekte wählen Sie ein Image nicht nur, weil es einfach zu starten ist. Prüfen Sie Wartungsstatus, unterstützte TYPO3-/PHP-Versionen, Image Tags, Sicherheitsupdates, persistente Volumes, Environment-Handling und Backup-Strategie, bevor Sie es in einem Live-Setup verwenden.

Volumes und Datenpersistenz in TYPO3 Docker verwalten

Volumes sind in TYPO3 Docker kritisch, weil sie Website-Daten sicher halten, wenn Container gestoppt, neu gebaut oder ersetzt werden.

Ohne korrektes Volume-Mapping können Uploads, Datenbankeinträge, Konfigurationsdateien und gecachte Assets während eines Container-Rebuilds verschwinden.

Wichtige TYPO3-Daten, die persistent gespeichert werden sollten:

• fileadmin/ – speichert hochgeladene Medien, Dokumente, Bilder und Site-Assets
• uploads/ – speichert im Backend hochgeladene Dateien in älteren oder bestimmten TYPO3 Setups
• typo3conf/ – speichert Konfiguration, Extensions und projektspezifische Einstellungen
• var/ oder typo3temp/ – speichert Cache, Logs und temporäre Dateien je nach TYPO3-Version
• Datenbank-Volume – speichert Seiten, Benutzer, Content-Einträge, Backend-Daten und Site-Konfiguration

Beispiel für Docker Volume Mapping:

services:
 web:
   image: webdevops/php-apache:8.2
   volumes:
     - .:/var/www/html
     - fileadmin:/var/www/html/public/fileadmin
     - uploads:/var/www/html/public/uploads
     - typo3conf:/var/www/html/public/typo3conf
 db:
   image: mariadb:10.6
   volumes:
     - dbdata:/var/lib/mysql
volumes:
 fileadmin:
 uploads:
 typo3conf:
 dbdata:

Häufiger Fehler: hochgeladene Dateien oder Datenbankdaten nur innerhalb des Containers zu speichern. Wenn dieser Container neu erstellt wird, können die Daten verloren gehen.

Für Team-Projekte sollten Sie einen klaren Prozess zum Teilen bereinigter Datenbank-Dumps und Dateipakete haben, damit jeder Entwickler mit einer sicheren und aktualisierten lokalen TYPO3-Umgebung arbeiten kann.

Ein zuverlässiges TYPO3 Docker Setup sollte temporäre Container-Dateien immer von permanenten Projektdaten trennen.

TYPO3 Docker Best Practices

Ein starkes TYPO3 Docker Setup sollte stabil, sicher, wiederholbar und für das Team einfach zu warten sein.

Befolgen Sie diese Best Practices:

• Umgebungen trennen: Verwenden Sie unterschiedliche Einstellungen für Entwicklung, Staging und Produktion.
• Composer richtig verwenden: Halten Sie composer.json und composer.lock für reproduzierbare Builds unter Versionskontrolle.
• Wichtige Versionen festlegen: Vermeiden Sie instabile PHP-, TYPO3 und Image Tags in ernsthaften Projekten.
• .env-Dateien sorgfältig verwenden: Speichern Sie Environment-Werte separat, aber legen Sie sensible Zugangsdaten niemals offen.
• OPcache aktivieren: Verbessern Sie die TYPO3 Performance, indem kompilierter PHP-Code gecacht wird.
• Redis bei Bedarf verwenden: Fügen Sie Redis für größere TYPO3-Projekte mit stärkeren Caching-Anforderungen hinzu.
• Wichtige Daten persistent speichern: Mappen Sie Volumes für fileadmin/, uploads, Konfigurationsdateien und Datenbankspeicher.
• Dev-Einstellungen in der Produktion vermeiden: Deaktivieren Sie Debug-Modus, Entwicklungstools und unnötiges Logging.
• Dienste intern halten: Geben Sie Datenbank, Redis oder Admin-Tools nicht öffentlich frei, sofern es nicht erforderlich und abgesichert ist.
• Häufige Befehle dokumentieren: Machen Sie es Entwicklern einfach, das Setup zu starten, zu stoppen, neu zu bauen, zurückzusetzen und zu debuggen.

Beispiel-Befehlskürzel:

up:

    docker-compose up -d

down:

    docker-compose down

logs:

    docker-compose logs -f

reset:

    docker-compose down -v
    docker-compose up -d

Bevor Sie TYPO3 Docker in Staging oder Produktion verwenden, prüfen Sie Sicherheit, Backups, persistenten Speicher, PHP-Einstellungen und freigegebene Ports.

Häufige TYPO3 Docker Probleme und Lösungen

Die meisten TYPO3 Docker Probleme entstehen durch falsche Konfiguration, fehlende Dienste, falsche Berechtigungen oder nicht gemappte Volumes.

Nützliche Diagnosebefehle:

docker-compose logs -f
docker ps
docker-compose logs db

Für DDEV-Projekte:

ddev logs
ddev describe
ddev composer diagnose

Prüfen Sie außerdem TYPO3 Logs innerhalb von:

var/log/
var/log/typo3.log

Bevor Sie Container neu bauen, bestätigen Sie immer, dass die Datenbank und hochgeladene Dateien in persistenten Volumes gespeichert sind.

Ein bestehendes TYPO3-Projekt dockerisieren

Ein bestehendes TYPO3-Projekt kann sicher in Docker verschoben werden, wenn Dateien, Datenbank, Composer-Setup und Environment-Werte korrekt gemappt werden.

Bevor Sie beginnen, prüfen Sie:

• Datenbank-Backup: Exportieren Sie einen sauberen Datenbank-Dump, bevor Sie Änderungen vornehmen.
• Projektstruktur: Bestätigen Sie, ob das Projekt Composer-basiert oder legacy ist.
• Web root: Prüfen Sie, ob TYPO3 aus public/, web/ oder einem anderen Document Root läuft.
• Dateispeicher: Verschieben Sie fileadmin/, uploads/ und Medien-Assets, ohne Referenzen zu ändern.
• Konfiguration: Prüfen Sie typo3conf/, Environment-Variablen, Datenbankzugangsdaten und lokale Einstellungen.
• PHP-Kompatibilität: Stimmen Sie die Docker PHP-Version mit der TYPO3-Version und den installierten Extensions ab.
• Persistente Volumes: Halten Sie Datenbankdaten und hochgeladene Dateien außerhalb des temporären Container-Dateisystems.

Grundlegender Migrationsablauf:

mysqldump -u USER -p OLD_DATABASE > typo3-backup.sql
mkdir my-typo3-docker
cd my-typo3-docker
# Add DDEV, WebDevOps, or custom Docker setup
# Copy TYPO3 project files into the correct web root
# Import the database into the Docker database container

Wenn das Projekt noch eine legacy Nicht-Composer-Struktur verwendet, dokumentieren Sie Webroot, Extensions und individuelle Pfade, bevor Sie es verschieben. Für langfristige Wartbarkeit sollten Sie in Betracht ziehen, das Projekt während der Migration in ein Composer-basiertes Setup umzuwandeln.

Der sicherste Ansatz ist, das dockerisierte TYPO3-Projekt zuerst lokal zu testen. Prüfen Sie Backend-Login, Frontend-Seiten, Mediendateien, Formulare, Extensions, Weiterleitungen und Dateireferenzen, bevor Sie das Setup zu Staging oder Produktion verschieben.

TYPO3 Docker Performance-Optimierung

TYPO3 Docker Performance hängt von PHP-Tuning, Caching, Datenbankkonfiguration, Dateihandling und davon ab, wie sauber die Dienste getrennt sind.

Wichtige Optimierungsschritte:

• OPcache aktivieren: Cachen Sie kompilierten PHP-Code, um die TYPO3 Antwortzeit zu verbessern.
• Redis für Caching verwenden: Fügen Sie Redis für größere Websites, komplexe Content-Strukturen oder Projekte mit hohem Traffic hinzu.
• Datenbank optimieren: Prüfen Sie Indexe, langsame Abfragen, Speichereinstellungen und Verbindungslimits.
• Images leichtgewichtig halten: Vermeiden Sie unnötige Pakete innerhalb von Docker Images.
• Dienste trennen: Führen Sie PHP, Webserver, Datenbank, Cache und Suche als separate Dienste aus.
• TYPO3 Caching abstimmen: Wählen Sie Cache-Backends basierend auf Projektgröße und Traffic-Anforderungen.
• Dev-Einstellungen in der Produktion vermeiden: Deaktivieren Sie Debug-Modus, Entwicklungstools und übermäßiges Logging.
• Dateifreigabe-Performance prüfen: Auf macOS oder Windows können große  fileadmin/ Ordner Docker verlangsamen. Verwenden Sie Docker Desktop Performance-Einstellungen, DDEV Performance-Tipps oder WSL2 unter Windows.

Für Staging und Produktion testen Sie die Performance in einer Umgebung, die dem Live-Setup nahekommt. Prüfen Sie Backend-Geschwindigkeit, Frontend-Ladezeit, Datenbankabfragen, Cache-Verhalten und Medienverarbeitung vor dem Release.

Sicherheit Best Practices für TYPO3 Docker

Sicherheit ist wichtig, wenn TYPO3 Docker über lokale Entwicklung hinaus verwendet wird, besonders für Staging- und Produktionsprojekte.

Befolgen Sie diese Sicherheitspraktiken:

• Dev-, Staging und Produktionseinstellungen trennen: Verwenden Sie keine lokalen Entwicklungseinstellungen auf Live-Websites.
• Environment-Variablen schützen: Vermeiden Sie es, Datenbankpasswörter, API Keys und Backend-Zugangsdaten offenzulegen.
• Docker Secrets verwenden, wo möglich: Halten Sie sensible Werte sicherer als reine Environment-Variablen.
• HTTPS in der Produktion erzwingen: Verwenden Sie SSL und sichere Webserver-Konfiguration.
• TYPO3 Kontext korrekt setzen: Verwenden Sie den Production-Kontext für Live-Umgebungen.
• Debug-Modus deaktivieren: Halten Sie Fehlerdetails vor öffentlichen Benutzern verborgen.
• Container-Zugriff begrenzen: Führen Sie nur erforderliche Dienste aus und vermeiden Sie unnötig offene Ports.
• Images aktuell halten: Verwenden Sie gepflegte Base Images und aktualisieren Sie Sicherheitspatches regelmäßig.

Ein sicheres TYPO3 Docker Setup sollte sensible Daten geschützt halten, Umgebungen klar trennen und vermeiden, Entwicklungstools auf Produktionsservern offenzulegen.

TYPO3 Docker in CI/CD Pipelines

CI/CD hilft TYPO3-Teams, Docker-basierte Projekte mit weniger manuellen Fehlern zu testen, zu bauen und bereitzustellen.

Ein grundlegender TYPO3 Docker CI/CD-Ablauf umfasst:

• Code Push: Entwickler pusht Änderungen zu Git.
• Dependency Check: Composer installiert und validiert erforderliche TYPO3-Pakete.
• Docker Build: Die Pipeline baut ein versioniertes TYPO3 Docker Image.
• Automatisiertes Testing: TYPO3 Checks, PHP Checks und grundlegende Frontend-/Backend-Tests laufen vor dem Deployment.
• Staging Deployment: Das getestete Image wird zuerst in eine Staging-Umgebung deployed.
• Production Release: Nach Freigabe wird dasselbe Image in die Produktion verschoben.
• Rollback-Plan: Frühere Image-Versionen werden bereitgehalten, falls das neue Release fehlschlägt.

Für sicherere Deployments vermeiden Sie es, direkt auf dem Produktionsserver zu bauen. Bauen Sie das Image einmal, testen Sie es richtig und promoten Sie dann dieselbe Version über Staging und Produktion hinweg.

Migration Guide – TYPO3 zu Docker verschieben

TYPO3 zu Docker zu verschieben erfordert die korrekte Behandlung von Datenbank, hochgeladenen Dateien, Composer-Setup und Environment-Konfiguration.

Befolgen Sie diese Migrations-Checkliste:

• Datenbank exportieren: Erstellen Sie ein vollständiges Backup, bevor Sie das Setup ändern.
• Projektstruktur prüfen: Bestätigen Sie, ob das Projekt Composer-basiert oder legacy ist.
• Hochgeladene Dateien verschieben: Übertragen Sie  fileadmin/, uploads und andere benutzergenerierte Assets.
• Konfigurationsdateien mappen: Prüfen Sie TYPO3-Einstellungen, Datenbankzugangsdaten und environment-spezifische Werte.
• Composer abstimmen: Stellen Sie sicher, dass composer.json und composer.lock zur TYPO3-Version passen.
• Docker-Dienste erstellen: Richten Sie PHP, Webserver, Datenbank, Cache und erforderliche Extensions ein.
• Zuerst lokal testen: Prüfen Sie Backend-Login, Frontend-Seiten, Mediendateien, Formulare und Extensions.
• Zu Staging verschieben: Validieren Sie das Docker Setup, bevor Sie es in der Produktion verwenden.

Die größten Migrationsrisiken sind fehlende hochgeladene Dateien, falsche Datenbankzugangsdaten, defekte Dateipfade, falsche PHP-Versionen und nicht gemappte persistente Volumes.

Wann sollten Sie TYPO3 mit Docker verwenden?

Verwenden Sie TYPO3 mit Docker, wenn das Projekt ein stabiles, wiederholbares und teamfreundliches Entwicklungs-Setup benötigt.

Docker ist eine gute Wahl für:

• Agenturprojekte: Mehrere Entwickler benötigen dasselbe Setup.
• Enterprise-Websites: Das Projekt hat komplexe Dienste, Staging-Workflows oder langfristige Wartungsanforderungen.
• Composer-basierte TYPO3-Projekte: Abhängigkeiten müssen kontrolliert und versioniert bleiben.
• Multi-Environment-Workflows: Entwicklung, Staging und Produktion benötigen bessere Konsistenz.
• CI/CD-Deployments: Das Team möchte automatisiertes Testing und kontrollierte Releases.

Docker ist möglicherweise nicht notwendig für eine sehr kleine TYPO3 Website, die von einer Person auf einfachem Hosting verwaltet wird. Aber für professionelle TYPO3-Entwicklung, Team-Workflows und skalierbare Projekte ist Docker normalerweise langfristig das bessere Setup.

Fazit

TYPO3 Docker macht Entwicklung schneller, sauberer und einfacher zu verwalten, besonders für Teams, die mit komplexen CMS-Projekten arbeiten. Mit dem richtigen Setup können Entwickler Environment-Probleme vermeiden, Abhängigkeiten besser verwalten, Projektdaten schützen und TYPO3-Websites für reibungsloseres Testing, Staging und Deployment vorbereiten.

Für lokale Entwicklung ist DDEV der einfachste Startpunkt. Für fortgeschrittene Projekte geben WebDevOps oder ein Custom Docker Compose Setup mehr Kontrolle über Dienste, Performance, Sicherheit und Produktions-Workflows.

Wenn Ihre TYPO3-Website auf einer älteren Version oder einem veralteten Setup läuft, ist dies der richtige Zeitpunkt, ein TYPO3 Upgrade zu planen. Ein korrektes Upgrade kann Sicherheit, Performance, Kompatibilität und langfristige Stabilität verbessern und gleichzeitig Ihre Website leichter wartbar machen.

Benötigen Sie Hilfe bei einem TYPO3 Upgrade oder Docker-basierten TYPO3 Setup? Kontaktieren Sie unsere TYPO3-Experten, um Ihre TYPO3-Website mit einem stabilen Entwicklungs- und Deployment-Workflow zu aktualisieren, zu optimieren und zu modernisieren.