Installing TYPO3 mit DDEV: Ein schrittweiser Leitfaden
TYPO3-Entwicklung ist am effizientesten, wenn sie in einer containerisierten Umgebung durchgeführt wird. DDEV bietet eine standardisierte lokale Entwicklungsumgebung, die systemspezifische Konfigurationsprobleme beseitigt und Konsistenz über Entwicklungsteams hinweg gewährleistet.
Warum DDEV für TYPO3 verwendet wird
DDEV vereinfacht die TYPO3 Entwicklung, indem es eine vorkonfigurierte Docker-basierte Umgebung mit allen erforderlichen Diensten wie PHP, Datenbank und Webserver bereitstellt. Dadurch entfällt die manuelle Einrichtung und umgebungsbedingte Fehler werden reduziert.
Warum ein Docker-basierter Workflow wichtig ist
Ein Docker-basierter Workflow stellt sicher, dass TYPO3 in einer isolierten und reproduzierbaren Umgebung ausgeführt wird. Das bedeutet:
- Konsistente Einrichtung für alle Entwickler
- Keine Abhängigkeitskonflikte auf lokalen Rechnern
- Einfaches Onboarding und Replizieren von Projekten
- Produktionsnahe Umgebung für sicherere Entwicklungs-Workflows
Schnelle Antwort: TYPO3 mit DDEV in 10 Minuten installieren
Sie können eine funktionierende lokale TYPO3-Entwicklungsumgebung mit DDEV und Composer in wenigen Schritten einrichten.
5-Schritte-Installationsablauf
Erstellen Sie ein Projektverzeichnis
mkdir typo3-project && cd typo3-projectInitialisieren Sie DDEV für TYPO3
ddev config --project-type=typo3 --docroot=public --create-docrootStarten Sie die DDEV-Umgebung
ddev startInstallieren Sie TYPO3 über Composer
ddev composer create "typo3/cms-base-distribution:^12"Führen Sie das TYPO3-Setup-Tool aus
ddev launch typo3/install.php
Ergebnis
Sie erhalten eine vollständig funktionsfähige TYPO3-Entwicklungsumgebung mit Webserver, Datenbank und E-Mail-Tests, die für die lokale Entwicklung bereit ist.
Aufschlüsselung der Benutzerabsichten
Dieser Leitfaden behandelt verschiedene Arten von Benutzerabsichten hinter Suchanfragen zur Installation von TYPO3 mit DDEV.
Anfängerabsicht
Benutzer, die eine einfache Schritt-für-Schritt-Einrichtung ohne tiefgehende technische Kenntnisse wünschen. Sie erwarten:
- Klare Installationsschritte
- Befehle zum Kopieren und Einfügen
- Minimale Komplexität bei der Konfiguration
Entwicklerabsicht
Benutzer, die mit TYPO3, Composer und Docker vertraut sind und Folgendes benötigen:
- Strukturierte DDEV-Projekteinrichtung
- Details zur TYPO3 Version kompatibilität (v12–v14)
- Sauberer lokaler Entwicklungs-Workflow
Fehlerbehebungsabsicht
Benutzer, die die Installation bereits ausprobiert haben und auf Probleme stoßen. Sie suchen nach:
- Lösungen für Einrichtungsfehler
- DDEV- oder Composer-Debugging
- Problemen mit Datenbank oder Installations-Tool
- Umgebungsbezogenen Problemen (Ports, Berechtigungen, Cache)
Agentur/DevOps-Absicht
Teams oder Fachleute, die skalierbare Umgebungen einrichten und Folgendes benötigen:
- Standardisierte TYPO3-Entwicklungseinrichtung
- Wiederverwendbare DDEV-Konfiguration
- Konsistenz über mehrere Projekte hinweg
- Produktionsnahe lokale Umgebungen
Systemanforderungen
Dieser Abschnitt definiert die minimalen technischen Anforderungen, die für die Installation und den Betrieb von TYPO3 mit DDEV in einer modernen lokalen Entwicklungsumgebung erforderlich sind.
Kernanforderungen
- Docker (neueste stabile Version)
- DDEV (v1.23+ empfohlen für TYPO3 Projekte)
- Composer 2.x für die Verwaltung von Abhängigkeiten
- TYPO3-Kompatibilität:
Unterstützung von Betriebssystemen
- Windows (erfordert WSL2 für optimale DDEV-Leistung)
- macOS (Intel und Apple Silicon werden unterstützt)
- Linux (native Unterstützung wird für beste Leistung empfohlen)
Checkliste vor der Installation (Fehlervermeidung)
Stellen Sie vor Beginn der Installation sicher, dass Ihre Umgebung ordnungsgemäß vorbereitet ist, um häufige Einrichtungsfehler zu vermeiden.
Erforderliche Prüfungen
- Docker ist installiert und läuft
- DDEV ist installiert und über die CLI verfügbar
- Composer ist installiert (Version 2 oder höher)
- Erforderliche Ports (80, 443, 3306) werden nicht verwendet
- Das System verfügt über ausreichend Arbeitsspeicher (mindestens 4 GB, 8 GB empfohlen für einen reibungslosen TYPO3-Betrieb)
- Internetzugang ist für Composer-Paketdownloads verfügbar
Diese Checkliste stellt eine stabile Umgebung sicher und verhindert die meisten häufig auftretenden TYPO3 + DDEV-Installationsfehler, bevor sie entstehen.
Installationsverzeichnis erstellen
Dieser Schritt richtet einen sauberen Arbeitsbereich ein, in dem das TYPO3-Projekt installiert wird.
Empfohlener Ansatz
Verwenden Sie eine klare, projektspezifische Namenskonvention, die sich gut für Agenturen und mehrere Umgebungen eignet:
mkdir typo3-project && cd typo3-projectWarum diese Struktur wichtig ist
- Vermeidet allgemeine Ordnernamen wie
t3example - Verbessert die Übersichtlichkeit bei Multi-Projekt-Setups
- Entspricht Entwicklungsstandards auf Agenturebene
- Erleichtert später die CI/CD und Git-Integration
Ein neues DDEV-Projekt erstellen
Nach der Vorbereitung des Projektverzeichnisses initialisieren Sie DDEV, um die TYPO3-Entwicklungsumgebung zu erstellen.
Grundlegender Konfigurationsbefehl
ddev config --project-type=typo3 --docroot=public --create-docrootWas diese Konfiguration bewirkt
- Setzt den Projekttyp auf TYPO3 (aktiviert optimierte Standardeinstellungen)
- Definiert
publicals Web-Root-Verzeichnis - Erstellt automatisch das Docroot, falls es nicht vorhanden ist
- Erstellt eine
.ddev-Konfiguration für die Container-Einrichtung
Warum dieser Schritt wichtig ist
DDEV verwendet diese Konfiguration, um eine konsistente Docker-basierte Umgebung mit PHP, Datenbank und Webserver-Diensten zu erstellen, die speziell für die TYPO3-Entwicklung optimiert ist.
Das DDEV-Projekt starten
Nach der Konfiguration starten Sie die lokale Entwicklungsumgebung mit DDEV. Dadurch werden alle erforderlichen Docker-Container für TYPO3 initialisiert.
ddev start
Was passiert beim Starten von DDEV
DDEV startet einen vollständigen lokalen Stack mit den folgenden Diensten:
- Webserver-Container (Apache/Nginx + PHP)
- Datenbank-Container (MariaDB/MySQL)
- Mailpit-Container (für E-Mail-Tests)
Wichtiger Hinweis
TYPO3 ist zu diesem Zeitpunkt noch nicht installiert. Dieser Schritt bereitet nur die lokale Laufzeitumgebung vor.
TYPO3 über Composer installieren
Sobald die DDEV-Umgebung läuft, installieren Sie TYPO3 mit Composer innerhalb des Containers.
ddev composer create “typo3/cms-base-distribution:^12”Versionskompatibilität (Standard 2026)
- TYPO3 v12 LTS → PHP 8.1
- TYPO3 v13 LTS → PHP 8.2
- TYPO3 v14 → PHP 8.3
Wichtiger Hinweis
Während der Installation werden Sie möglicherweise aufgefordert, das Überschreiben vorhandener Dateien zu bestätigen. Dies ist bei neuen Projekt-Setups zu erwarten und sollte akzeptiert werden.
Das TYPO3-Setup-Tool ausführen
Nach der Installation muss TYPO3 mit dem Setup-Prozess initialisiert werden. Dies kann auf zwei Arten erfolgen:
Option 1: CLI-Setup (Empfohlen für Entwickler)
ddev exec ./vendor/bin/typo3 setup
Dieser Befehl startet einen interaktiven Setup-Assistenten im Terminal.
Option 2: Browser Setup (Install Tool)
Erstellen Sie die FIRST_INSTALL-Datei:
ddev exec touch public/FIRST_INSTALLStarten Sie den Installer:
ddev launch typo3/install.php- Schließen Sie den Setup-Assistenten im Browser ab.
Zusammenfassung
- Das CLI-Setup ist schneller und automatisierungsfreundlich
- Das Browser-Setup ist einfacher für Anfänger und Erstinstallationen
Nachinstallations-Setup (Abschnitt mit hohem Mehrwert)
Nach der Installation von TYPO3 besteht der nächste Schritt darin, das System für die erste Nutzung zu konfigurieren. Dadurch wird sichergestellt, dass Backend, Site-Konfiguration und anfängliche Inhaltsstruktur bereit sind.
Backend-Anmeldeablauf
- Greifen Sie über
/typo3auf das TYPO3 Backend zu - Melden Sie sich mit den während der Einrichtung erstellten Admin-Zugangsdaten an
- Überprüfen Sie den erfolgreichen Zugriff auf das Backend-Dashboard
Admin-Benutzer-Setup
- Stellen Sie sicher, dass der erste Admin-Benutzer über vollständige Systemberechtigungen verfügt
- Erstellen Sie zusätzliche Backend-Benutzer, wenn Sie in einer Teamumgebung arbeiten
- Weisen Sie bei Bedarf geeignete Rollen und Zugriffsebenen zu
Site-Konfiguration
- Definieren Sie die Haupt-Site im Modul Site Management
- Konfigurieren Sie die Basis-URL (wichtig für Routing und Links)
- Legen Sie Spracheinstellungen und den Site-Identifier fest
- Überprüfen Sie bei Bedarf die Verfügbarkeit des TypoScript-Templates
Erste Seite erstellen
- Erstellen Sie eine Root-Seite im Seitenbaum
- Legen Sie diese als Website-Root fest (über die Seiteneigenschaften)
- Fügen Sie erste Inhaltselemente hinzu, um die Frontend-Darstellung zu überprüfen
DDEV-Architektur-Erklärung
Das Verständnis darüber, wie DDEV ein TYPO3-Projekt strukturiert, hilft bei der Fehlerbehebung und der langfristigen Wartung.
Container-Struktur
DDEV führt TYPO3 innerhalb isolierter Docker-Container aus:
- Web-Container: PHP-Laufzeitumgebung + Webserver
- Datenbank-Container: MariaDB/MySQL-Speicher
- Mailpit-Container: Erfasst ausgehende E-Mails für Tests
Warum der public Ordner verwendet wird
- Dient als Web-Root (Document Root)
- Stellt sicher, dass nur öffentliche Ressourcen über den Browser zugänglich sind
- Hält Systemdateien für mehr Sicherheit außerhalb des öffentlichen Zugriffs
Übersicht über config.yaml
Die Datei .ddev/config.yaml definiert:
- Projekttyp (TYPO3)
- PHP-Version
- Webserver-Konfiguration
- Port-Zuordnung und Routing-Regeln
Diese Datei stellt sicher, dass die Umgebung auf allen Entwickler-Rechnern reproduzierbar ist.
Datenbank und E-Mail-Verwaltung (Services-Ebene)
DDEV bietet integrierte Tools zur Verwaltung von Datenbanken und zum Testen von E-Mails ohne externe Einrichtung.
Datenbankzugriff
ddev launch -p
- Öffnet eine Datenbankverwaltungsoberfläche (z. B. phpMyAdmin/Adminer abhängig von der Einrichtung)
- Wird verwendet, um TYPO3 Datenbank tabellen zu überprüfen und zu verwalten
E-Mail-Tests
ddev launch -m
- Öffnet die Mailpit-Oberfläche
- Erfasst alle ausgehenden TYPO3-E-Mails lokal
- Nützlich zum Testen von Passwort-Zurücksetzungen und Systembenachrichtigungen
Konfigurationsquelle
Datenbank und E-Mail-Einstellungen werden automatisch konfiguriert in:
config/system/additional.php
Zusammenfassung
- Datenbank und E-Mail sind in DDEV vorkonfiguriert
- Keine manuelle Servereinrichtung erforderlich
- Ideal für schnelle lokale Entwicklungs und Test-Workflows
Entwickler-Tools-Setup (DDEV + TYPO3)
Dieser Abschnitt konzentriert sich darauf, die Debugging-Effizienz und die Entwicklerproduktivität während der TYPO3-Entwicklung zu verbessern.
Xdebug-Setup
- Aktivieren Sie Xdebug in der DDEV-Projektkonfiguration
- Konfigurieren Sie die IDE-Integration (PhpStorm / VS Code)
- Verwenden Sie Breakpoints für Backend- und Frontend-Debugging
- Überprüfen Sie den PHP-Anfrageablauf innerhalb von TYPO3-Controllern und Extbase
Speicherorte der Logs
TYPO3 und DDEV-Logs sind für die Fehlerbehebung unerlässlich.
- TYPO3-Logs:
var/log/
- System-Level-Logs:
- DDEV-Container-Protokolle über
ddev logs
- DDEV-Container-Protokolle über
- Webserver-Logs:
- Über die DDEV-Container-Ausgabe zugänglich
Debugging-Workflow
Empfohlener Workflow für die TYPO3-Entwicklung:
- Aktivieren Sie bei Bedarf den TYPO3-Dev-Kontext
- Verwenden Sie Xdebug für die schrittweise Ausführung
- Überwachen Sie Logs in Echtzeit mit DDEV
- Leeren Sie den Cache, wenn Konfigurationsänderungen nicht übernommen werden
- Überprüfen Sie Datenbankabfragen über Debugging-Tools oder SQL-Inspektion
Fehlerbehebung bei häufigen Problemen
Dieser Abschnitt behandelt die häufigsten Probleme, die während der Einrichtung von TYPO3 + DDEV auftreten, sowie deren Lösungen.
Installation schlägt fehl
- Überprüfen Sie die Composer-Version (muss 2.x sein)
- Stellen Sie sicher, dass ausreichend Speicher für Composer verfügbar ist
- Überprüfen Sie die richtige TYPO3-Paketversion
Port-Konflikte (80/443/3306)
- Stoppen Sie kollidierende Dienste (Apache, MySQL, nginx)
- Ändern Sie bei Bedarf die DDEV-Ports
- Starten Sie die DDEV-Umgebung neu
Composer-Speicherfehler
- Erhöhen Sie das PHP-Speicherlimit für die CLI
- Verwenden Sie bei Bedarf
COMPOSER_MEMORY_LIMIT=-1
Datenbankverbindungsfehler
- Stellen Sie sicher, dass DDEV läuft
- Überprüfen Sie, ob
.envoder die Konfiguration mit den DDEV-Zugangsdaten übereinstimmt - Starten Sie den Datenbank-Container neu
Berechtigungsprobleme (Linux / WSL)
- Beheben Sie den Dateibesitz innerhalb des Projektverzeichnisses
- Stellen Sie sicher, dass die Benutzerberechtigungen für Docker-Volumes korrekt sind
Install Tool wird nicht geladen
- Stellen Sie sicher, dass die Datei
FIRST_INSTALLinpublic/vorhanden ist - Leeren Sie den Browser-Cache
- Starten Sie das DDEV-Projekt neu
TYPO3 in DDEV zurücksetzen / neu installieren
Dieser Abschnitt erklärt, wie ein TYPO3-Projekt innerhalb von DDEV sicher zurückgesetzt oder vollständig neu installiert werden kann.
Vollständiger Projekt-Reset
- DDEV-Projekt stoppen
- Container und Volumes entfernen
- Vorhandene Datenbank löschen
ddev delete --omit-snapshotWorkflow für einen sauberen Neuaufbau
- Projekt mit
ddev configerneut initialisieren - TYPO3 über Composer neu installieren
- Installations-Setup-Tool erneut ausführen
Sicherer Neuinstallations-Workflow
- Notwendige Konfigurationen bei Bedarf sichern
- vendor und Datenbank entfernen
- Den vollständigen Installationsprozess von Grund auf erneut ausführen
Zusammenfassung
Dieser Reset-Workflow stellt einen sauberen Zustand sicher, um fehlerhafte Installationen zu debuggen oder Entwicklungsumgebungen schnell neu zu erstellen.
Performance und Best Practices
Dieser Abschnitt behandelt Optimierungstechniken, um eine schnellere und stabilere TYPO3-Entwicklungsumgebung mit DDEV sicherzustellen.
Composer-Optimierung
- Verwenden Sie
composer install --optimize-autoloaderfür eine produktionsnahe Performance - Bevorzugen Sie
--no-devfür Produktions-Builds (nicht für lokale DDEV-Umgebungen) - Aktualisieren Sie regelmäßig Abhängigkeiten, um veraltete Pakete zu vermeiden
- Verwenden Sie den Composer-Cache, um wiederholte Installationen zu beschleunigen
Cache-Bereinigung (TYPO3)
- Leeren Sie den TYPO3-Cache nach Konfigurationsänderungen
- Verwenden Sie die Cache-Bereinigung im Backend oder CLI-Befehle bei Bedarf
- Vermeiden Sie Probleme durch veraltete Caches während der Extension-Entwicklung
Trennung von Entwicklung und Produktion
- Verwenden Sie DDEV ausschließlich für die lokale Entwicklung
- Replizieren Sie keine Produktionsoptimierungen lokal, außer zu Testzwecken
- Verwenden Sie separate
.env-Konfigurationen für Entwicklungs- und Produktionsumgebungen - Vermeiden Sie die Aktivierung von Produktions-Caching-Strategien in lokalen Setups
Sicherheitshinweise (Lokale Entwicklung)
Dieser Abschnitt hebt Sicherheitsaspekte hervor, die beim Betrieb von TYPO3 in einer lokalen DDEV-Umgebung berücksichtigt werden sollten.
Lokales HTTPS-Vertrauen (mkcert-Konzept)
- DDEV unterstützt HTTPS über lokal vertrauenswürdige Zertifikate
- Verwenden Sie ein auf mkcert basierendes Vertrauen für eine sichere lokale Entwicklung
- Stellt sicher, dass sich der Browser wie in einer Produktionsumgebung verhält
Hinweis zur Entwicklungsumgebung
- Verwenden Sie die DDEV-Konfiguration nicht in der Produktion
- Lokale Setups können Debugging-Tools und detaillierte Fehlermeldungen offenlegen
- Deaktivieren Sie Debugging-Funktionen vor der Bereitstellung
- Halten Sie Zugangsdaten und sensible Daten von Produktionssystemen getrennt
Fazit
Die TYPO3 Installation mit DDEV bietet eine schnelle, zuverlässige und reproduzierbare lokale Entwicklungsumgebung. Durch die Kombination von Docker, Composer und DDEV erhalten Sie ein vollständig containerisiertes Setup, das Systemabhängigkeitsprobleme beseitigt und die Entwicklung über Teams hinweg standardisiert.
Wenn Sie diesem Leitfaden folgen, verfügen Sie jetzt über:
- Eine funktionierende lokale TYPO3-Entwicklungsumgebung
- Eine auf Composer basierende Projektstruktur
- Ein vollständig konfiguriertes DDEV-Setup mit Datenbank- und E-Mail-Unterstützung
- Einen wiederholbaren Workflow für zukünftige Projekte
Nächste Schritte
- Beginnen Sie mit dem Aufbau Ihrer TYPO3-Site-Struktur
- Installieren Sie erforderliche Extensions basierend auf den Projektanforderungen
- Konfigurieren Sie TypoScript und Site-Einstellungen
- Gehen Sie zur Produktionsbereitstellung über, sobald Sie bereit sind
FAQs
Ja. TYPO3 v12, v13 und v14 funktionieren alle mit DDEV, wenn kompatible PHP-Versionen verwendet werden (8.1–8.3 abhängig von der TYPO3-Version).
Ja. DDEV basiert auf Docker, daher ist Docker für die Ausführung von TYPO3 in diesem Setup zwingend erforderlich.
Häufige Gründe sind:
- Falsche Composer-Version
- Fehlende PHP-Speicherzuweisung
- Port-Konflikte
- Unvollständige DDEV-Einrichtung
- Fehlende Datenbankverbindung während der Einrichtung
Ja. DDEV ist nur eine lokale Entwicklungsumgebung. Sie können Dateien, Datenbank und Konfiguration auf jeden Produktionsserver migrieren.
Diese Meldung erscheint, wenn der Setup-Prozess noch nicht abgeschlossen wurde. Sie müssen nach der Composer-Installation das TYPO3-Setup-Tool (setup oder install.php) ausführen.
Ja. Moderne TYPO3-Installationen (v12+) basieren auf Composer und benötigen Composer für die Verwaltung von Abhängigkeiten.
Ansprechpartner für Internetagentur und TYPO3 Projekte
Sven Thelemann
Servicepartner - Deutschland
Sven Thelemann
Client Service LeadSven Thelemann ist Client Service Lead bei NITSAN und konzentriert sich auf die Bereitstellung von TYPO3 Lösungen, die den Kundenzielen entsprechen. Mit seinem ausgeprägten Verständnis für Technologie und Kundenerwartungen sorgt er für eine reibungslose Kommunikation und Projektabwicklung. Außerhalb der Arbeit fährt Sven Thelemann gerne Fahrrad und experimentiert mit selbstgemachten Rezepten.
Sei der erste der kommentiert