TYPO3 mit DDEV installieren: Anleitung für v14 und v13

TYPO3 mit DDEV installieren: Anleitung für v14 und v13

Willkommen zu diesem Schritt-für-Schritt-Leitfaden zur Installation von TYPO3 mit DDEV für die lokale Entwicklung. In diesem Tutorial richten Sie eine neue TYPO3-Instanz mit Composer innerhalb einer Docker-basierten DDEV-Umgebung ein, was zu einer schnellen, reproduzierbaren Einrichtung führt, die auf allen Maschinen konstant funktioniert. Die Anleitung führt Sie in 8 Schritten zum Ziel.

Dieser Leitfaden ist für Entwickler und Teams gedacht, die eine zuverlässige lokale TYPO3-Umgebung ohne manuelle Konfiguration von PHP, Webservern oder Datenbanken möchten. Egal, ob Sie ein neues Projekt starten oder eine saubere Entwicklungsumgebung vorbereiten, DDEV vereinfacht den gesamten Prozess.

Bevor Sie beginnen, stellen Sie sicher, dass Docker und DDEV auf Ihrem System installiert und ausgeführt werden, da sie für die Installation erforderlich sind.

Wenn Sie TYPO3 nicht lokal, sondern auf Cloud-Plattformen bereitstellen möchten, können Sie diese Leitfäden erkunden:

Gehen wir die Einrichtung jetzt Schritt für Schritt durch, bis Ihre lokale TYPO3-Website läuft.

Kurze Antwort: Um TYPO3 mit DDEV zu installieren, öffnen Sie einen leeren Ordner und führen ddev config --project-type=typo3 --docroot=public --php-version=8.4, ddev start, ddev composer create-project "typo3/cms-base-distribution:^14" und ddev typo3 setup aus. Das Backend öffnen Sie mit ddev launch /typo3/. Für TYPO3 v13 LTS verwenden Sie ^13 statt ^14.

Das Wichtigste in Kürze

  • TYPO3 v14 LTS (14.3) ist die Empfehlung für neue Projekte, v13.4 LTS die Version für bestehende Projekte.
  • Beide Versionen unterstützen PHP 8.2 bis 8.5; das offizielle TYPO3-Tutorial für DDEV nutzt PHP 8.4.
  • Composer starten Sie mit ddev composer direkt vom Rechner aus; ddev ssh ist für die Installation nicht nötig.
  • ddev typo3 setup richtet TYPO3 mit einem Befehl ein; der Web-Installer funktioniert weiterhin über eine FIRST_INSTALL-Datei.
  • Ab TYPO3 14.1 liefert das Standardtheme Camino sofort eine funktionierende Demo-Website.
  • DDEV läuft unter macOS (auch Apple Silicon), Windows mit WSL2 und Linux, mit OrbStack, Docker Desktop, Rancher Desktop, Colima, Lima oder Docker CE.

Getestet mit / gültig für: TYPO3 v14.3 LTS und v13.4 LTS, Befehle abgeglichen mit der aktuellen DDEV- und TYPO3-Dokumentation. Aktualisiert: November 2026

Aktualisiert am 11. November 2026 | T3Planet-Redaktion

Diese Befehle stammen aus den offiziellen Schnellstarts von TYPO3 und DDEV für eine neue TYPO3-Installation mit TYPO3 v14 LTS. Führen Sie sie in einem leeren Ordner aus, in dem weder Git noch eine IDE schon Dateien angelegt hat.

TYPO3 v14 LTS (empfohlen für neue Projekte)

 

mkdir my-typo3-site && cd my-typo3-site

ddev config --project-type=typo3 --docroot=public --php-version=8.4

ddev start

ddev composer create-project "typo3/cms-base-distribution:^14"

ddev composer require typo3/theme-camino

ddev typo3 setup --server-type=other --driver=mysqli --host=db --port=3306 --dbname=db --username=db --password=db --create-site=https://my-typo3-site.ddev.site

ddev launch /typo3/

 

Der Setup-Befehl fragt Admin-Benutzername, Passwort, E-Mail und Projektnamen ab. Danach läuft Ihre Website unter https://my-typo3-site.ddev.site, das Backend unter /typo3/.

TYPO3 v13.4 LTS (bestehende Projekte)

Gehen Sie genauso vor, verwenden Sie aber "typo3/cms-base-distribution:^13", lassen Sie das Camino-Theme weg (es kam mit TYPO3 14.1) und rufen Sie ddev typo3 setup ohne --create-site auf.

Welche Setup-Methode passt zu Ihnen?

MethodeFunktioniert inGeeignet fürZu beachten
ddev typo3 setup (Konsole)v13.4, v14Schnelle, wiederholbare Installationen und SkripteDDEV-Datenbankwerte übergeben (db/db/db, Host db)
Web-Installer (FIRST_INSTALL + /typo3/install.php)v13.4, v14Geführte Einrichtung im BrowserVorher die Datei public/FIRST_INSTALL anlegen
Camino-Standardthemeab v14.1Sofort eine funktionierende Demo-WebsiteNicht in v13; nur begrenzt anpassbar
ddev ssh + composer im Containerv13.4, v14Längere Arbeit in der Container-ShellFür die Installation unnötig; ddev composer läuft vom Host aus

Quellen (englisch): TYPO3 Getting Started: Installing TYPO3 with DDEV (v14), dieselbe Seite für v13.4 und die DDEV CMS Quickstarts.

Voraussetzungen: Docker (oder ein anderer Docker-Provider) und DDEV müssen installiert sein und laufen.

TYPO3 ist ein kostenloses, Open-Source-Content-Management-System (CMS), das entwickelt wurde, um Unternehmen und Organisationen bei der Erstellung, Verwaltung und Erweiterung ihrer Websites zu unterstützen. Gegründet im Jahr 1997 von Kasper Skårhøj, ist TYPO3 eine der am weitesten verbreiteten CMS-Plattformen für Unternehmen, insbesondere in Europa.

TYPO3 ist in PHP geschrieben und verwendet TypoScript, eine leistungsstarke Konfigurationssprache, die fortschrittliche Anpassungen und Flexibilität ermöglicht. Es läuft direkt in Ihrem Browser und liefert Inhalte mithilfe von Standard-HTML und JavaScript, sodass keine spezielle Client-Software erforderlich ist.

TYPO3 eignet sich für Projekte jeder Größenordnung. Ob Sie eine kleine Unternehmenswebsite, ein Universitätsportal oder eine große Unternehmensplattform verwalten, TYPO3 kann skalieren, um Ihren Anforderungen gerecht zu werden.

Warum Entwickler, Marketer und Agenturen TYPO3 wählen

TYPO3 ist eine Open-Source-Plattform, die mit Ihrem Projekt wächst und dabei Stabilität und Kontrolle bewahrt. Zu den wichtigsten Stärken gehören:

  • Modularität: Bauen Sie genau das, was Sie benötigen, mit einem flexiblen Erweiterungssystem.
  • Sicherheit & Stabilität: Langfristige Unterstützung (LTS)-Versionen bieten zuverlässige Updates und Sicherheits-Patches für Jahre.
  • Skalierbarkeit: Unterstützt alles von kleinen Websites bis hin zu komplexen globalen Plattformen.
  • Community-getriebene Entwicklung: Eine große internationale Community verbessert und wartet das System kontinuierlich.

TYPO3 in Zahlen

TYPO3 betreibt weltweit mehr als 500.000 aktive Websites, was es zu einer bewährten und vertrauenswürdigen Wahl für webbasierte Unternehmensprojekte macht.

Lesen Sie mehr TYPO3 Fakten. um dessen Möglichkeiten und die praktische Anwendung zu untersuchen.

TYPO3 bietet eine robuste Reihe von Unternehmensfunktionen, die für Organisationen entwickelt wurden, die Flexibilität, Sicherheit und langfristige Zuverlässigkeit erfordern. Es unterstützt komplexe Website-Strukturen und bleibt gleichzeitig durch das umfangreiche Erweiterungssystem hochgradig anpassbar.

Wichtige Vorteile umfassen:

  • Detaillierte Benutzerrollen & Berechtigungen: Kontrollieren Sie den Zugriff auf detaillierter Ebene für Redakteure, Manager und Administratoren.
  • Multisite-Verwaltung: Verwalten Sie mehrere Websites von einer einzigen TYPO3-Installation aus, ideal für Unternehmen und Institutionen.
  • Erweiterbarkeit: Ein großes Ecosystem von Erweiterungen ermöglicht es Ihnen, Funktionen hinzuzufügen, ohne die Kernfunktionen neu zu erstellen.
  • Skalierbarkeit & Leistung: entwickelt, um alles von kleinen Projekten bis hin zu großen, hochgradigen Plattformen zu bewältigen.
  • Langfristige Unterstützung: Regelmäßige LTS-Versionen gewährleisten Stabilität, Sicherheitsupdates und vorhersehbare Wartungszyklen.

TYPO3 eignet sich besonders gut für Unternehmen, öffentliche Institutionen und digitale Agenturen, die ein skalierbares CMS benötigen, das komplexe Anforderungen über viele Jahre hinweg unterstützt.

Bevor Sie mit der TYPO3-Installation mit DDEV beginnen, stellen Sie sicher, dass Ihr System die erforderlichen Voraussetzungen erfüllt. Die lokale Ausführung von TYPO3 mit DDEV hängt von einer containerisierten Umgebung ab, in der einige wesentliche Tools zusammenarbeiten.

Die folgenden Komponenten sind erforderlich, um eine stabile und effiziente TYPO3 DDEV-Installation einzurichten.

Docker

Docker ist die Grundlage der TYPO3 Docker-Installation. Es stellt isolierte Container zur Verfügung, die TYPO3 unabhängig von Ihrem Host-System ausführen, sodass Versionskonflikte vermieden und ein konsistentes Verhalten auf verschiedenen Maschinen sowie in den Umgebungen der Teammitglieder gewährleistet wird.

DDEV

DDEV ist ein lokales Entwicklungstool, das auf Docker basiert und die Projektinstallation und -verwaltung vereinfacht. Mit einer kleinen Anzahl von Befehlen stellt es eine vollständige TYPO3 Entwicklung umgebung bereit, einschließlich Webserver, PHP und Datenbankdiensten.

Betriebssystem

DDEV unterstützt Windows, macOS und Linux und benötigt einen Docker-Provider: unter macOS OrbStack, Lima, Docker Desktop, Rancher Desktop oder Colima, unter Windows WSL2 mit Docker CE in WSL2, Docker Desktop oder Rancher Desktop, unter Linux Docker CE aus dem offiziellen Docker-Repository (DDEV-Doku zur Docker-Installation).

PHP-Kompatibilität

Die erforderliche PHP-Version hängt von der TYPO3-Version ab, die Sie installieren möchten. DDEV ermöglicht es Ihnen, die PHP-Version in der Projektkonfiguration festzulegen, sodass Sie die Systemanforderungen von TYPO3 problemlos erfüllen können, ohne PHP manuell zu installieren. TYPO3 v14 und v13.4 unterstützen jeweils PHP 8.2, 8.3, 8.4 und 8.5 (get.typo3.org).

Datenbank (MySQL/MariaDB)

TYPO3 benötigt eine Datenbank, um Inhalte, Konfigurationen und Benutzerdaten zu speichern. DDEV stellt automatisch eine MariaDB-Datenbank bereit (vollständig kompatibel mit MySQL), wodurch die manuelle Einrichtung einer Datenbank entfällt.

SSH-Zugang

Ein SSH-Interface wird verwendet, um mit den laufenden Containern zu interagieren. Befehle wie ddev ssh ermöglichen den Zugriff auf den Webcontainer, das Verwalten von Dateien und das direkte Ausführen von Composer innerhalb der TYPO3-Umgebung.

Composer & Git

Composer ist erforderlich, um TYPO3-Pakete zu installieren und Abhängigkeiten in modernen TYPO3-Projekten zu verwalten. Git wird empfohlen, um die Versionskontrolle zu gewährleisten, insbesondere wenn Sie mit einem Team zusammenarbeiten oder ein Projekt-Repository pflegen.

Nun können Sie mit dem Schritt-für-Schritt-Leitfaden fortfahren, um TYPO3 mit DDEV zu installieren.

Um TYPO3 mit DDEV effizient auszuführen, sollte Ihr System bestimmte Hardware- und Plattformanforderungen erfüllen. Während TYPO3 auf bescheidenen Setups laufen kann, bietet containerisierte Entwicklung mit Docker bei ausreichenden Ressourcen und richtiger OS-Konfiguration eine deutlich bessere Leistung.

Empfohlene Hardware-Ressourcen

Für eine reibungslose lokale Entwicklung, insbesondere beim Ausführen von Docker-Containern, werden die folgenden Mindestanforderungen empfohlen:

  • RAM: Mindestens 8 GB (16 GB empfohlen für größere Projekte)
  • CPU: Moderner Multi-Core-Prozessor (Intel i5 / AMD Ryzen 5 oder höher)
  • Festplattenspeicher: Mindestens 10–20 GB freier Speicherplatz für Container, Images und Projektdateien
  • SSD-Speicher: Starke Empfehlung für schnellere Container-Leistung und Dateioperationen

Unzureichende Ressourcen können zu langsamen Container-Startzeiten, trägem Backend-Performance oder Build-Fehlern führen.

Betriebssystemspezifische Überlegungen (Windows, macOS, Linux)

DDEV und Docker unterstützen alle gängigen Desktop-Betriebssysteme, aber die Einrichtung variiert je nach Plattform:

  • Windows: Installieren Sie zuerst WSL2. DDEV empfiehlt Docker CE innerhalb von WSL2; Docker Desktop und Rancher Desktop funktionieren ebenfalls. Der DDEV-Installer für Windows kann Docker CE in WSL2 direkt mit einrichten.
  • macOS: Die DDEV-Dokumentation nennt OrbStack als empfohlenen und schnellsten Provider (kommerziell), Lima, Rancher Desktop und Colima als kostenlose Open-Source-Alternativen und Docker Desktop als weitere Option. Lima und Colima arbeiten ohne Zusatzkonfiguration nur mit Projekten im Home-Verzeichnis.
  • Linux: Bietet typischerweise die beste Leistung, da Docker nativ läuft. Stellen Sie sicher, dass Ihr Benutzer die Berechtigung hat, Docker-Befehle ohne sudo auszuführen.

Unabhängig vom Betriebssystem, stellen Sie sicher, dass Virtualisierung in den BIOS/UEFI-Einstellungen Ihres Systems aktiviert ist.

Apple Silicon & WSL2 Hinweise

Moderne Hardwareplattformen erfordern einige zusätzliche Überlegungen:

  • Apple Silicon: Wird von DDEV und allen oben genannten macOS-Providern unterstützt. Halten Sie DDEV und Ihren Docker-Provider aktuell, da ältere eigene Images oft nicht für ARM gebaut sind.
  • Windows WSL2: Essenziell für eine effiziente Ausführung von Docker unter Windows. Stellen Sie sicher, dass Ihre Linux-Distribution aktualisiert und mit Docker Desktop integriert ist.
  • Cross-Architecture-Projekte: Wenn Sie mit Teams arbeiten, die unterschiedliche Hardwarearchitekturen verwenden, kann der erste Build auf der jeweiligen Architektur länger dauern, bleibt aber danach konsistent.

Das Erfüllen dieser Anforderungen gewährleistet eine stabile, schnelle und reproduzierbare TYPO3-Entwicklungsumgebung mit DDEV.

Bevor Sie TYPO3 installieren, stellen Sie sicher, dass Docker und DDEV korrekt auf Ihrem System installiert und ausgeführt werden. Die Überprüfung Ihrer Umgebung im Voraus hilft, Installationsfehler, Container-Startprobleme und Konfigurationsfehler später im Prozess zu vermeiden.

Überprüfen Sie die Docker-Installation

Überprüfen Sie, ob Docker installiert, ausgeführt und von der Kommandozeile aus zugänglich ist.

Ausführen:

 

docker --version

 

Sie sollten die installierte Docker-Version sehen. Wenn der Befehl nicht erkannt wird oder einen Fehler zurückgibt, stellen Sie sicher, dass Docker Desktop (Windows/macOS) oder Docker Engine (Linux) ordnungsgemäß installiert und ausgeführt wird.

Um zu bestätigen, dass der Docker-Dienst aktiv ist, können Sie auch ausführen:

 

docker info

 

Dieser Befehl zeigt systemweite Details zur Docker-Umgebung an. Wenn Docker nicht läuft, starten Sie es, bevor Sie fortfahren.

Überprüfen Sie die DDEV-Installation

Überprüfen Sie nun, ob DDEV korrekt installiert und funktionsfähig ist.

Ausführen:

 

ddev --version

 

Dies sollte die installierte DDEV-Version zurückgeben. Wenn nicht, installieren Sie DDEV gemäß den offiziellen Installationsanweisungen für Ihre Plattform.

Sie können auch testen, ob DDEV mit Docker kommunizieren kann, indem Sie ausführen:

 

ddev poweroff

 

Dieser Befehl stoppt alle laufenden DDEV-Projekte und überprüft, ob DDEV Docker-Container erfolgreich steuern kann.

Eine vollständige Prüfung von Docker, Netzwerk, DNS und HTTPS-Zertifikaten erhalten Sie mit ddev utility diagnose (DDEV-Befehlsreferenz).

Sobald sowohl Docker als auch DDEV überprüft wurden, ist Ihr System bereit, mit der TYPO3-Installation über DDEV fortzufahren.

Überprüfen Sie die verfügbaren Ports & laufenden Container

Bevor Sie Ihr TYPO3-Projekt starten, stellen Sie sicher, dass die erforderlichen Netzwerkports frei sind und keine Konflikte mit bereits laufenden Containern bestehen. Portkonflikte sind eine häufige Ursache für Startfehler in Docker-basierten Umgebungen.

DDEV verwendet in der Regel die Ports 80 (HTTP) und 443 (HTTPS) für das Routing lokaler Projekte. Wenn ein anderer Dienst (z. B. Apache, Nginx, IIS oder ein anderer Docker-Container) bereits diese Ports verwendet, kann Ihre Umgebung nicht starten.

Überprüfen Sie die laufenden Docker-Container

Listen Sie aktive Container auf:

 

docker ps

 

Wenn Sie Container sehen, die Webserver-Images verwenden oder wichtige Ports belegen, stoppen Sie diese, bevor Sie fortfahren.

Um alle laufenden Container zu stoppen (wenn dies sicher ist):

 

docker stop $(docker ps -q)

 

Überprüfen Sie die Portnutzung auf Ihrem System

Überprüfen Sie, ob die Ports 80 oder 443 bereits verwendet werden.

Auf Linux/macOS:

 

lsof -i :80

lsof -i :443

 

Auf Windows (PowerShell):

 

netstat -ano | findstr :80

netstat -ano | findstr :443

 

Wenn eine andere Anwendung diese Ports verwendet, stoppen oder konfigurieren Sie diesen Dienst um, bevor Sie DDEV starten

Stoppen Sie bestehende DDEV-Projekte (falls vorhanden)

Wenn Sie zuvor andere DDEV-Projekte ausgeführt haben, schalten Sie diese aus, um Konflikte zu vermeiden:

 

ddev poweroff

 

Dies stoppt alle laufenden DDEV-Umgebungen auf Ihrem Computer.

Die Sicherstellung, dass die erforderlichen Ports verfügbar sind und keine Konflikte mit aktiven Containern bestehen, hilft dabei, Ihre TYPO3 DDEV-Umgebung sauber und zuverlässig zu starten.

Die Verwendung von DDEV mit TYPO3 bietet einen modernen, containerbasierten Ansatz für die lokale Entwicklung, der manuelle Serverkonfigurationen und Umgebungsinkonsistenzen eliminiert.

Anstatt PHP, Webserver und Datenbanken direkt auf Ihrem Computer zu installieren und zu pflegen, stellt DDEV alles in isolierten Docker-Containern bereit, was zu einer sauberen, reproduzierbaren Einrichtung führt.

Bevor wir die Vorteile näher betrachten, ist es hilfreich, zu verstehen, was TYPO3 DDEV eigentlich bedeutet.

Was ist TYPO3 DDEV?

TYPO3 DDEV bezieht sich auf die Verwendung des TYPO3 CMS zusammen mit dem DDEV-Tool für die lokale Entwicklung, um eine schnelle, konsistente und einfach zu verwaltende Entwicklungsumgebung zu schaffen.

DDEV ist ein Docker-basiertes lokales Entwicklungssystem, das die Einrichtung von Webserver-, PHP-Laufzeit- und Datenbankdiensten automatisiert.

Es ermöglicht Ihnen, vollständig funktionale TYPO3-Umgebungen innerhalb von Minuten zu erstellen, ohne Apache/Nginx, PHP-Versionen oder MySQL manuell konfigurieren zu müssen. Da die Umgebung containerisiert ist, verhält sie sich auf verschiedenen Maschinen und Betriebssystemen gleich.

TYPO3-Projekte profitieren von der integrierten Unterstützung von DDEV, wodurch es einfach wird, neue Projekte zu starten oder Teammitglieder schnell einzuarbeiten.

Hauptvorteile der Installation von TYPO3 mit DDEV

Die Installation von TYPO3 mit DDEV bietet praktische Vorteile für Entwickler, Teams und Agenturen, die an lokalen oder kollaborativen Projekten arbeiten. Der Fokus liegt auf Zuverlässigkeit, Geschwindigkeit und Konsistenz statt auf manueller Einrichtung.

  • Konsistenz: Jedes Teammitglied arbeitet mit einer identischen Entwicklungsumgebung, wodurch „funktioniert auf meinem Rechner“-Probleme reduziert werden.
  • Automatisierung: Häufige Aufgaben wie Shell-Zugriff, Composer-Operationen und Datenbankverwaltung sind in einfache DDEV-Befehle integriert.
  • Flexibilität: Zusätzliche Dienste wie Redis oder Solr können bei Bedarf mit minimaler Konfiguration hinzugefügt werden.
  • Isolation: Die TYPO3-Umgebung läuft separat vom Host-System, wodurch Konflikte mit anderen Projekten vermieden werden.
  • Community-Support: DDEV wird aktiv gepflegt und ist innerhalb des TYPO3-Ökosystems weit verbreitet, was kontinuierliche Kompatibilität und Dokumentation gewährleistet.

Diese Kombination macht DDEV zu einer zuverlässigen Wahl für moderne TYPO3-Entwicklungsabläufe.

DDEV verwendet Docker, um eine containerisierte Umgebung zu erstellen, die alle für TYPO3 erforderlichen Dienste lokal ausführt. Anstatt einen vollständigen Webstack auf Ihrem Computer zu installieren und zu konfigurieren, orchestriert DDEV dedizierte Container, die zusammenarbeiten, um Ihre Website bereitzustellen.

So funktioniert es:

  • Sie führen ddev-Befehle auf Ihrem lokalen Computer aus.
  • Die DDEV-CLI verwaltet und koordiniert die zugrunde liegenden Docker-Container.
  • Der Webcontainer führt die Apache/PHP-Umgebung aus und greift auf Ihre Projektdateien zu (normalerweise im public/-Verzeichnis).
  • Der Datenbankcontainer führt MariaDB aus und speichert TYPO3-Inhalte und -Konfigurationen.
  • Ihr Browser greift über eine lokale Domain (zum Beispiel https:// my-typo3-project(.)ddev(.)site) auf das Projekt zu, die den Verkehr an den Webcontainer weiterleitet.

Diese Architektur gewährleistet Isolation, Konsistenz über verschiedene Maschinen hinweg und eine einfache Reproduzierbarkeit von Entwicklungsumgebungen.

TYPO3 folgt einem festen Release-Zyklus, der professionellen Projekten langfristige Stabilität gibt. Für ein neues DDEV-Projekt im November 2026 kommen nur zwei Versionen in Frage: TYPO3 v14 LTS und TYPO3 v13.4 LTS.

TYPO3-VersionStatusAktuelles ReleaseKostenloser Support bisEinsatz
v14 LTSStabil, empfohlen14.3.10 (22.10.2026)30.06.2029Neue Projekte
v13.4 LTSVorgängerversion13.4.37 (22.10.2026)31.12.2027Bestehende Projekte
  • LTS (Long-Term Support): kostenlose Bug- und Sicherheitsfixes durch das TYPO3-Projekt.
  • ELTS (Extended Long-Term Support): kostenpflichtige Verlängerung nach dem Ende des kostenlosen Supports. TYPO3 v12 ist seit dem 30. April 2026 nur noch über ELTS versorgt; solche Projekte sollten auf v13 oder v14 aktualisiert werden.

Quelle: get.typo3.org, Stand November 2026.

In DDEV legen Sie die PHP-Version pro Projekt in der .ddev/config.yaml fest (oder mit ddev config --php-version). PHP muss also nicht auf Ihrem Rechner installiert sein.

PHP- & TYPO3-Kompatibilität

TYPO3-VersionUnterstützte PHP-VersionenPHP im offiziellen DDEV-Tutorial
14 LTS8.2, 8.3, 8.4, 8.58.4
13.4 LTS8.2, 8.3, 8.4, 8.58.4

Hinweis zur Migration: Projekte auf TYPO3 v12 oder älter sollten Sie aktualisieren, bevor Sie neue Funktionen bauen; stellen Sie in DDEV die PHP-Version der Ziel-Version von TYPO3 ein.

Quellen: get.typo3.org und TYPO3 Getting Started (englisch).

Für neue TYPO3-Installationen wird empfohlen, die neueste Long-Term Support (LTS)-Version zu verwenden. LTS-Versionen bieten mehrere Jahre lang Sicherheitsupdates, Bugfixes und Kompatibilitätsverbesserungen, wodurch sie die sicherste und stabilste Wahl für Produktions- und langfristige Entwicklungsprojekte darstellen.

Aktuell ist TYPO3 v14 LTS die bevorzugte Option für neue Projekte, da sie moderne Funktionen, verbesserte Leistung und erweiterte Supportabdeckung bietet.

Hinweis: TYPO3 v14 erfordert PHP 8.2 oder höher. Das offizielle TYPO3-Tutorial für DDEV verwendet PHP 8.4 und eine Composer-basierte Installation.

Warum die neueste LTS-Version wählen?

  • Langer Supportzeitraum: Erhalten Sie regelmäßige Sicherheits- und Wartungsupdates über Jahre hinweg.
  • Moderne Technologie-Stack: Unterstützt aktuelle PHP-Versionen und zeitgemäße Entwicklungsmethoden.
  • Bessere Leistung & Sicherheit: Beinhaltet Optimierungen und verstärkte Sicherheitsfunktionen.
  • Zukunftssichere Entwicklung: Reduziert den Bedarf an kurzfristigen Upgrades.
  • Erweiterungskompatibilität: Die meisten aktiv gepflegten Erweiterungen richten sich auf die neuesten LTS-Versionen.

Ältere Versionen (wie ELTS-Versionen) werden in der Regel nur verwendet, um Legacy-Systeme zu pflegen, die nicht sofort aktualisiert werden können.

Beim Erstellen eines neuen TYPO3-Projekts mit DDEV stellt die Auswahl der neuesten LTS-Version die zuverlässigste Grundlage für Entwicklung, Tests und Bereitstellung sicher.

Bevor Sie TYPO3 installieren, stellen Sie sicher, dass die erforderlichen Tools auf Ihrem System installiert und korrekt ausgeführt werden. Dieses Tutorial geht von einer lokalen Entwicklungsumgebung aus, die Docker und die DDEV-CLI verwendet.

Um mitzumachen, benötigen Sie:

  • Docker installiert und ausgeführt
    • macOS: OrbStack, Lima, Docker Desktop, Rancher Desktop oder Colima
    • Windows: WSL2 mit Docker CE, Docker Desktop oder Rancher Desktop; Linux: Docker CE
  • DDEV CLI installiert

DDEV installieren (falls noch nicht installiert)

Wählen Sie die Methode für Ihr Betriebssystem aus der offiziellen DDEV-Installationsanleitung:

  • macOS (Homebrew): brew install ddev/ddev/ddev
  • Linux oder macOS (Installationsskript): curl -fsSL https://ddev.com/install.sh | bash
  • Debian/Ubuntu: DDEV-apt-Repository von packages.ddev.com einbinden, dann sudo apt-get install -y ddev
  • Windows: DDEV-Installer für Windows oder WinGet (winget install DDEV)

Alle Schritte je Methode finden Sie in der DDEV-Installationsanleitung (englisch). Führen Sie nach der ersten Installation einmal mkcert -install aus, damit Ihr Browser den lokalen HTTPS-Zertifikaten vertraut.

Installation überprüfen

Nach der Installation von Docker und DDEV bestätigen Sie, dass beide Tools verfügbar und funktionsfähig sind:

 

docker --version  
ddev --version

 

Diese Befehle sollten die installierten Versionsnummern anzeigen. Wenn beide gültige Ausgaben zurückgeben und Docker ausgeführt wird, ist Ihre Umgebung bereit für die TYPO3 DDEV-Einrichtung.

TYPO3-Projekte können auf zwei verschiedene Arten installiert werden: Die moderne Composer-basierte Methode und die ältere klassische (legacy) Installation. Das Verständnis der Unterschiede hilft Ihnen, die richtige Einrichtung für Ihr Projekt und Ihren Entwicklungsworkflow zu wählen.

Composer-basierte Installation (Empfohlen)

Composer ist der Standard-Abhängigkeitsmanager für moderne TYPO3-Projekte. Bei dieser Methode werden die TYPO3 Kern-Pakete und Erweiterungen über Composer installiert und verwaltet, was eine bessere Kontrolle über Versionen und Updates ermöglicht.

Wichtige Merkmale:

  • TYPO3 Core wird als Composer-Paket installiert
  • Abhängigkeiten werden automatisch verwaltet
  • Einfachere Upgrades und Wartung
  • Unterstützt moderne Entwicklungs-Workflows und CI/CD
  • Empfohlen für neue Projekte und Teamumgebungen

Diese Methode wird von DDEV vollständig unterstützt und entspricht den aktuellen TYPO3 Best Practices.

Klassische / Legacy-Installation

Die klassische Installationsmethode besteht darin, TYPO3 als Standalone-Paket (z. B. von der TYPO3 website) herunterzuladen und es direkt im Webverzeichnis zu platzieren, ohne Composer zu verwenden.

Typische Anwendungsfälle:

  • Wartung älterer oder Legacy-Projekte
  • Umgebungen, in denen Composer nicht verwendet wird
  • Schnelle Evaluierungen von TYPO3 ohne Abhängigkeitsmanagement

Obwohl diese Methode weiterhin funktioniert, macht sie Updates, Erweiterungsverwaltung und langfristige Wartung im Vergleich zu Composer-basierten Setups schwieriger.

Welche Methode sollten Sie wählen?

  • Wählen Sie die Composer-basierte Installation für neue Projekte, professionelle Entwicklungs-Workflows und langfristige Wartbarkeit.
  • Verwenden Sie die klassische Installation nur, wenn Sie mit Legacy-Systemen arbeiten oder wenn Composer nicht verwendet werden kann.

Für die meisten modernen TYPO3-Projekte, die in DDEV ausgeführt werden, ist die Composer-basierte Methode die empfohlene und zukunftssichere Option.

Beginnen Sie damit, einen neuen Ordner für Ihr TYPO3 Projekt zu erstellen und in diesen zu navigieren. Dieses Verzeichnis wird Ihre Projektdateien und die DDEV-Konfiguration enthalten.

mkdir my-typo3-project  

cd my-typo3-project

Für eine frische Installation kann dieser Ordner leer sein. DDEV wird die notwendigen Konfigurations- und Umgebungsdateien während der Einrichtung automatisch generieren.

Sobald Sie sich im Projektverzeichnis befinden, führen Sie den Konfigurationsbefehl aus:

ddev config

Ohne Rückfragen geht es, wenn Sie alle Werte direkt übergeben, wie im offiziellen TYPO3-Tutorial:

 

ddev config --project-type=typo3 --docroot=public --php-version=8.4

 

DDEV fordert Sie zur Eingabe mehrerer Projekteinstellungen auf und erstellt dann einen versteckten .ddev/-Ordner, der wichtige Konfigurationsdateien enthält, wie zum Beispiel:

  • config.yaml — Hauptprojekkonfiguration
  • docker-compose.*.yaml — Optionale Service-Overrides

Diese Dateien definieren, wie Ihre TYPO3-Umgebung innerhalb von Docker ausgeführt wird.

Projektname

Geben Sie einen Projektnamen an (z. B. my-typo3-project). Dieser Name wird von DDEV verwendet, um das Projekt zu identifizieren und die lokale Domain zu generieren.

Docroot-Konfiguration

Legen Sie das Dokumentenstammverzeichnis auf das Verzeichnis fest, das vom Webserver bedient werden soll. Bei modernen TYPO3 Composer-basierten Installationen ist dies typischerweise:

public

Stellen Sie sicher, dass der docroot mit dem Ordner übereinstimmt, in dem sich die öffentlichen Webdateien von TYPO3 befinden. Ein falscher docroot kann zu 404-Fehlern oder einer nicht funktionierenden Seite führen.

Hinweis: Wenn Sie mit einem bestehenden TYPO3-Projekt arbeiten, überprüfen Sie das korrekte Web-Stammverzeichnis (z. B. public/, web/ oder ein anderes benutzerdefiniertes Verzeichnis), bevor Sie fortfahren.

Auswahl des Projekttyps

Wenn Sie nach dem Projekttyp gefragt werden, wählen Sie:

typo3

Die Auswahl des TYPO3-Projekttyps aktiviert optimierte Standardkonfigurationen, die speziell für TYPO3-Entwicklungen zugeschnitten sind, einschließlich entsprechender Webserver-Konfigurationen und Umgebungsvariablen.

Nach Abschluss der Eingabeaufforderungen generiert DDEV das .ddev/-Konfigurationsverzeichnis. Ihr Projekt ist nun bereit für den nächsten Schritt: die Umgebung zu starten und TYPO3 zu installieren.

Sobald DDEV konfiguriert ist, starten Sie das Projekt und installieren TYPO3 mit Composer. ddev composer führt Composer im Web-Container aus, also mit der PHP-Version aus Ihrer DDEV-Konfiguration. ddev ssh brauchen Sie dafür nicht.

DDEV-Umgebung starten

 

ddev start

 

Der Befehl startet die benötigten Docker-Container, darunter:

  • Web-Container
  • Datenbank-Container (standardmäßig MariaDB)
  • Weitere Dienste wie Router und Mailpit

TYPO3-Projekt mit Composer anlegen

Für TYPO3 v14 LTS:

 

ddev composer create-project "typo3/cms-base-distribution:^14"

 

Für TYPO3 v13.4 LTS:

 

ddev composer create-project "typo3/cms-base-distribution:^13"

 

Der Befehl installiert das Projekt im Projektordner und legt public/ als Web-Root an. Geben Sie public nicht als Zielordner an, sonst entsteht ein zweites, verschachteltes Projekt.

Empfohlen für v14: das Standardtheme Camino

Seit TYPO3 14.1 liefert der Core ein Standardtheme mit. Die TYPO3-Dokumentation empfiehlt es für Erstinstallationen:

 

ddev composer require typo3/theme-camino

 

Dateibesitz & Berechtigungen

DDEV führt Befehle im Web-Container mit Ihrer eigenen Benutzer-ID aus, chown ist daher normalerweise nicht nötig. Bei Schreibfehlern prüfen Sie, ob Ihr Docker-Provider den Projektordner einbinden kann (Lima und Colima binden standardmäßig nur das Home-Verzeichnis ein).

Danach enthält der Ordner unter anderem composer.json, config, packages, public und vendor. Die Datenbank bleibt leer, bis Sie das Setup ausführen.

TYPO3 v13 und v14 lassen sich auf zwei Wegen einrichten: per Konsolenbefehl oder mit dem webbasierten Install Tool. Der Konsolenbefehl ist am schnellsten.

Variante 1: Setup über die Konsole (empfohlen)

 

ddev typo3 setup --server-type=other --driver=mysqli --host=db --port=3306 --dbname=db --username=db --password=db

 

Beantworten Sie die Fragen nach Admin-Benutzername, Passwort, E-Mail und Projektname. Wenn nach einer Basis-Website gefragt wird, geben Sie Ihre DDEV-URL ein, zum Beispiel https://my-typo3-site.ddev.site.

Variante 2: Web-Installer (1-2-3 Install Tool)

 

ddev exec touch public/FIRST_INSTALL

ddev launch /typo3/install.php

 

DDEV stellt diese Datenbankzugangsdaten bereit. Tragen Sie sie ein, wenn der Installer danach fragt:

  • Host: db
  • Datenbankname: db
  • Benutzername: db
  • Passwort: db
  • Port: 3306

Entwicklungskontext setzen

TYPO3 startet im Kontext „Production“. Für aussagekräftigere Fehlermeldungen während der Entwicklung ergänzen Sie in der .ddev/config.yaml Folgendes und führen ddev restart aus:

 

web_environment:
- TYPO3_CONTEXT=Development/DDEV

 

Quelle: TYPO3 setup on first installation (englisch).

Hinweis: Wenn Sie einen 404-Fehler oder die Meldung eines fehlenden Verzeichnisses erhalten, prüfen Sie, ob der Docroot in der .ddev/config.yaml auf public steht.

Der Installationsassistent führt Sie durch die verbleibenden Konfigurationsschritte.

Schritt 1 — Systemumgebungsüberprüfung

TYPO3 überprüft die erforderlichen PHP-Erweiterungen, Berechtigungen und die Serverkonfiguration.
Beheben Sie alle gemeldeten Probleme, bevor Sie fortfahren.

Schritt 2 — Datenbankkonfiguration

Geben Sie die Datenbank-Anmeldedaten ein (oder verwenden Sie die Standardwerte von DDEV). TYPO3 nutzt diese Datenbank zum Speichern von Inhalten und Einstellungen.

Schritt 3 — Datenbank auswählen oder erstellen

Wählen Sie eine bestehende leere Datenbank aus oder lassen Sie TYPO3 eine neue Datenbank automatisch erstellen.

Schritt 4 – Backend-Benutzer und Website erstellen

Richten Sie das Administratorkonto ein und nehmen Sie die Erstkonfiguration der Website vor. Verwenden Sie ein sicheres Passwort für den Backend-Zugriff.

Schritt 5 – Installation abschließen

Geben Sie den Namen der Website ein und entscheiden Sie, ob Sie eine Distribution installieren oder mit einem leeren Projekt beginnen möchten.

Schritt 6 – Anmeldung im Backend

Nach Fertigstellung, TYPO3-Weiterleitungen Sie zum Anmeldebildschirm des Backends.

Nach dem Abschluss des Installationsassistenten stellen Sie sicher, dass Ihre TYPO3-Instanz korrekt funktioniert. Die Überprüfung des Zugriffs auf das Backend und Frontend stellt sicher, dass die Umgebung, die Datenbank und die Konfiguration wie erwartet arbeiten.

Zugriff auf das TYPO3-Backend

Öffnen Sie die Login-Seite des TYPO3-Backends in Ihrem Browser. Sie können in der Regel über folgende URL darauf zugreifen:

 

ddev launch /typo3/

 

Geben Sie die Administrator-Anmeldeinformationen ein, die während der Installation erstellt wurden. Ein erfolgreicher Login zeigt an, dass die TYPO3-Core-Dienste und die Authentifizierung funktionstüchtig sind.

Überprüfung der Verfügbarkeit der Frontend-Seite

Besuchen Sie die Haupt-URL des Projekts:

 

ddev launch

 

Mit dem Camino-Theme unter TYPO3 v14 und einer beim Setup angelegten Basis-Website sehen Sie die Demo-Website. ddev describe zeigt alle URLs des Projekts.

Die Seite sollte ohne Fehler geladen werden. Abhängig von Ihrer Einrichtung sehen Sie möglicherweise eine Standardseite, eine leere Vorlage oder die installierte Distribution.

Bestätigung, dass der Admin-Login funktioniert

Nachdem Sie sich ins Backend eingeloggt haben:

  • Überprüfen Sie, dass das Dashboard korrekt geladen wird
  • Navigieren Sie zu den Core-Modulen (Seite, Liste, Einstellungen)
  • Bestätigen Sie, dass keine Systemwarnungen oder Fehler angezeigt werden
  • Erstellen Sie optional eine Testseite oder ein Inhaltselement, um sicherzustellen, dass Datenbank-Schreibvorgänge korrekt funktionieren

Eine erfolgreiche Interaktion bestätigt, dass TYPO3, die Datenbankverbindung und die Datei-Berechtigungen korrekt konfiguriert sind.

AI-Assistenten an Ihr lokales TYPO3 anbinden

Das kostenlose MCP-Starter-Kit für TYPO3 zeigt, wie Sie AI-Assistenten sicher an das TYPO3-Backend anbinden, Leitplanken setzen und erste Aufgaben umsetzen, mit Excel-Rollout-Blatt.

MCP-Starter-Kit kostenlos laden

Die meisten DDEV-Probleme haben drei Ursachen: ein gestoppter Docker-Provider, belegte Ports 80/443 oder ein falscher Docroot. Starten Sie mit ddev utility diagnose; der Befehl prüft Docker, Netzwerk, DNS und HTTPS in einem Durchlauf.

DDEV-Container starten nicht

Wenn ddev start fehlschlägt:

  • Stellen Sie sicher, dass Docker ausgeführt wird
  • Überprüfen Sie die verfügbaren Systemressourcen (RAM/CPU)
  • Starten Sie Docker neu und versuchen Sie es erneut
  • Überprüfen Sie die Protokolle auf Fehler:

ddev logs

Portkonflikte

Konflikte treten auf, wenn ein anderer Dienst die Ports 80 oder 443 verwendet.

 

Lösungen:

  • Stoppen Sie lokale Webserver (Apache, Nginx, IIS)
  • Stoppen Sie andere Docker-Container
  • Führen Sie aus:

ddev poweroff

Starten Sie dann Ihr Projekt neu.

Berechtigungsprobleme

Symptome können Dateischreibfehler oder fehlgeschlagene Installationen sein.

 

Mögliche Lösungen:

  • Legen Sie das Projekt im Home-Verzeichnis ab (bei Lima und Colima standardmäßig Pflicht)
  • Führen Sie Composer nicht mit sudo auf dem Host aus, sondern mit ddev composer
  • Starten Sie das Projekt neu, damit DDEV die Mounts korrigiert:

ddev restart

Datenbankverbindungsfehler

Wenn TYPO3 keine Verbindung zur Datenbank herstellen kann:

  • Bestätigen Sie, dass der Datenbank-Container ausgeführt wird
  • Verwenden Sie die Standard-DDEV-Anmeldeinformationen, falls Sie unsicher sind:
    • Host: db
    • Datenbank: db
    • Benutzername: db
    • Passwort: db
  • Starten Sie die Umgebung neu:

ddev restart

Installations-Tool von TYPO3 lädt nicht

Wenn das Installations-Tool nicht angezeigt wird:

  • Prüfen Sie beim Web-Installer, ob public/FIRST_INSTALL existiert, und öffnen Sie /typo3/install.php
  • Überprüfen Sie, ob die TYPO3-Dateien im richtigen docroot installiert wurden
  • Bestätigen Sie, dass die .ddev/config.yaml auf das richtige Verzeichnis verweist (z. B. public)
  • Leeren Sie den Browser-Cache oder versuchen Sie einen anderen Browser
  • Starten Sie DDEV neu:

ddev restart

Leere Seite oder 500-Fehler

Interne Serverfehler deuten normalerweise auf Konfigurations- oder Abhängigkeitsprobleme hin.

 

Empfohlene Überprüfungen:

  • Überprüfen Sie die TYPO3-Protokolle im Projektverzeichnis
  • Überprüfen Sie die DDEV-Protokolle:

ddev logs

  • Leeren Sie die TYPO3-Caches: ddev typo3 cache:flush -v
  • Stellen Sie sicher, dass die erforderlichen PHP-Erweiterungen verfügbar sind
  • Überprüfen Sie die Dateiberechtigungen und die Datenbankverbindung

Die Behebung dieser häufigen Probleme löst die meisten Schwierigkeiten bei der TYPO3-Installation mit DDEV.

Nach Abschluss der Installation interagieren Sie hauptsächlich mit der DDEV-Umgebung, um Ihr Projekt zu verwalten.

Der .ddev Ordner

Der  .ddev/ Ordner enthält Konfigurationsdateien, die Ihre lokale Umgebung definieren:

  • config.yaml — Hauptprojektkonfiguration (PHP-Version, docroot, Projekttyp)
  • docker-compose.*.yaml — Optionale Service-Definitionen oder Überschreibungen
  • db_snapshots/ — Ordner enthält Konfigurationsdateien, die Ihre lokale Umgebung definieren:

Example configuration:

 

name: my-typo3-project

type: typo3

docroot: public

php_version: "8.4"

webserver_type: nginx-fpm

web_environment:
- TYPO3_CONTEXT=Development/DDEV

 

Häufige DDEV-Befehle

Diese Befehle helfen Ihnen, Ihre lokale TYPO3-Umgebung zu steuern und Fehler zu beheben:

  • ddev start — Startet die Projekt-Container
  • ddev stop — Stoppt das aktuelle Projekt
  • ddev poweroff — Stoppt alle laufenden DDEV-Projekte
  • ddev ssh — Zugriff auf die Web-Container-Shell
  • ddev composer [args] — Führen Sie Composer innerhalb des Containers aus
  • ddev exec [command] — Führen Sie beliebige Befehle im Container aus
  • ddev logs — Anzeige der Container-Protokolle zum Debuggen
  • ddev describe — Zeigt Projekt-URLs und Service-Details an
  • ddev launch: öffnet die Website; ddev launch /typo3/ öffnet das Backend
  • ddev typo3 [Befehl]: führt die TYPO3-Konsole aus, zum Beispiel ddev typo3 cache:flush
  • ddev xdebug toggle: schaltet Xdebug ein oder aus
  • ddev snapshot: sichert die Datenbank vor riskanten Änderungen

Das Verständnis dieser Befehle wird tägliche Entwicklungsaufgaben und Wartung vereinfachen.

DDEV ermöglicht es Ihnen, Ihre TYPO3-Entwicklungsumgebung zu erweitern, indem Sie zusätzliche Dienste wie Caching-Systeme oder Suchmaschinen hinzufügen und TYPO3 extensions installieren.

Diese Komponenten laufen zusammen mit Ihrem Projekt in Containern und können mit minimaler Konfiguration aktiviert werden.

Beispiel: Redis hinzufügen

Redis kann für Caching oder Sitzungs-Speicherung verwendet werden, um die Leistung zu verbessern.

Nutzen Sie das offizielle DDEV-Add-on, statt eine Docker-Compose-Datei von Hand zu schreiben:

 

ddev add-on get ddev/ddev-redis

ddev restart

 

In der Add-on-Registry finden Sie weitere offizielle Add-ons wie ddev/ddev-memcached. Installierte Add-ons zeigt ddev add-on list --installed (DDEV-Add-ons).

Installieren von TYPO3-Erweiterungen

Die Funktionalität von TYPO3 kann durch die Installation von Erweiterungen mit Composer oder der klassischen dateibasierten Methode erweitert werden.

Composer-basierte Installation (empfohlen):

Im Projektordner:

 

ddev composer require georgringer/news

 

Wie Sie TYPO3-Extensions über Composer installieren und aktualisieren, zeigt unsere ausführliche Anleitung.

Dies installiert die Erweiterung und ihre Abhängigkeiten in einer modernen TYPO3-Installation.

Klassische Installationsmethode:

Bei älteren Projekten können die Erweiterungsdateien direkt in folgendem Verzeichnis abgelegt werden:

public/typo3conf/ext/ 

Beide Methoden werden in einer DDEV-Umgebung unterstützt.

DDEV kann auch verwendet werden, um ein bestehendes TYPO3-Projekt lokal auszuführen. Statt eine neue Installation zu erstellen, konfigurieren Sie DDEV um den bestehenden Code, installieren die Abhängigkeiten und importieren die Projektdatenbank.

Vorhandenen Code importieren

Legen Sie Ihre bestehenden TYPO3-Projektdateien in einem lokalen Verzeichnis ab und navigieren Sie zu diesem Verzeichnis:

cd path/to/your-typo3-project

Stellen Sie sicher, dass das Projekt die TYPO3-Core-Dateien und das korrekte Web-Stammverzeichnis enthält (z. B. public/, web/ oder ein anderes konfiguriertes Verzeichnis).

Initialisieren Sie DDEV im Projektordner:

ddev config --project-type=typo3

Folgen Sie den Aufforderungen, um den Projektnamen und den Dokumentenstamm festzulegen.

Abhängigkeiten installieren

Für Composer-basierte Projekte installieren Sie die benötigten Pakete innerhalb des Containers:

ddev st

ddev composer install

Dies stellt den TYPO3-Core, Erweiterungen und Abhängigkeiten wieder her, die in composer.json definiert sind.

Für nicht Composer-basierte (Legacy) Projekte stellen Sie sicher, dass alle benötigten Dateien und Erweiterungen im Projektverzeichnis vorhanden sind.

Datenbank importieren

TYPO3 benötigt die Projektdatenbank, um korrekt zu funktionieren. Importieren Sie ein Datenbank-Dump in die DDEV-Umgebung:

ddev import-db --file=path/to/database.sql.gz

DDEV akzeptiert unkomprimierte und komprimierte Dumps (.sql, .sql.gz, .sql.zst, .zip und weitere) (DDEV-Datenbankverwaltung). Nach dem Import erkennt TYPO3 die bestehenden Inhalte und die Konfiguration der Website.

Konfiguration und Docroot anpassen

Überprüfen Sie, ob der in .ddev/config.yaml konfigurierte Dokumentenstamm mit dem Web-Verzeichnis des Projekts übereinstimmt (häufig public/).

Überprüfen Sie auch die TYPO3-Konfigurationsdateien (z. B. die Datenbankverbindungsdaten), falls erforderlich. In den meisten Fällen können die DDEV-Datenbankanmeldeinformationen verwendet werden:

  • Host: db
  • Datenbank: db
  • Benutzername: db
  • Passwort: db
  • Starten Sie die Umgebung neu, um Änderungen anzuwenden:

ddev restart

Ihr bestehendes TYPO3-Projekt sollte nun lokal innerhalb der DDEV-Umgebung laufen.

Bewährte Praktiken für die Verwaltung einer stabilen, reproduzierbaren und effizienten lokalen TYPO3-Entwicklungsumgebung mit DDEV

Umgebung in Git verwalten

Commiten Sie das .ddev/-Verzeichnis in Ihr Versionskontrollsystem, sodass alle Teammitglieder dieselbe Umgebungsconfiguration teilen.

Vermeiden Sie das Commiten von Dateien, die sensible Daten enthalten (z. B. lokale Überschreibungen mit Anmeldeinformationen).

Mit der im Git verfolgten Konfiguration können Mitwirkende das Repository klonen und das Projekt mit folgendem Befehl starten:

ddev start

 

Dies stellt sicher, dass die Entwicklungsumgebungen im gesamten Team konsistent sind.

Verwendung von Xdebug

Xdebug ermöglicht das schrittweise Debuggen von PHP-Code.

Schalten Sie Xdebug im Projektordner ein:

ddev xdebug on

 

Xdebug bleibt aktiv, bis Sie das Projekt neu starten. Ausschalten mit:

ddev xdebug off

 

Konfigurieren Sie Ihre IDE (wie PhpStorm oder VS Code), um auf Debugging-Verbindungen zu hören, in der Regel auf Port 9003. Sie können dann Haltepunkte setzen und Variablen während der Ausführung inspizieren.

Datenbank-Snapshots

DDEV bietet eine Snapshot-Funktionalität für das Sichern und Wiederherstellen der Projekt-Datenbank.

Erstellen Sie einen Snapshot:

ddev snapshot

 

Dies erstellt ein komprimiertes Archiv im .ddev/db_snapshots/-Verzeichnis.

Wiederherstellen eines Snapshots:

ddev snapshot restore [snapshotname]

 

Snapshots sind nützlich, um Entwicklungsstände zu bewahren oder Änderungen sicher zu testen.

PHP-Konfiguration überschreiben

Benutzerdefinierte PHP-Einstellungen können mit Überschreibungsdateien angewendet werden.

Erstellen Sie die Datei:

.ddev/php/ini-overrides.ini

Fügen Sie die erforderlichen Konfigurationswerte hinzu, zum Beispiel:

memory_limit = 512M  

max_execution_time = 240

Starten Sie DDEV neu, um die neuen Einstellungen anzuwenden:

ddev restart

 

Dieser Ansatz ermöglicht eine Feinabstimmung der Laufzeitumgebung, ohne die globalen Systemeinstellungen zu ändern.

Die Optimierung Ihrer lokalen Umgebung kann die TYPO3 Leistung erheblich verbessern, wenn es innerhalb von DDEV ausgeführt wird. Eine richtige Konfiguration reduziert Ladezeiten, beschleunigt Builds und sorgt für einen reibungsloseren Entwicklungsworkflow.

Xdebug-Leistungsüberlegungen

Xdebug ist für das Debuggen unerlässlich, kann jedoch die PHP-Ausführung merklich verlangsamen, wenn es aktiviert ist.

Empfehlungen:

  • Aktivieren Sie Xdebug nur, wenn Sie aktiv debuggen.
  • Deaktivieren Sie es während der normalen Entwicklung, um die Leistung zu verbessern.
  • Schalten Sie Xdebug ohne Dateiänderung um:

ddev xdebug toggle

Den aktuellen Status zeigt ddev xdebug status.

Speicher & Ausführungseinstellungen

Große TYPO3-Projekte oder Erweiterungsinstallationen erfordern möglicherweise höhere PHP-Ressourcenlimits.

Passen Sie die Einstellungen mit einer PHP-Überschreibungsdatei an:

.ddev/php/ini-overrides.ini

Passen Sie die Einstellungen mit einer PHP-Überschreibungsdatei an:

 

memory_limit = 512M

max_execution_time = 240

upload_max_filesize = 64M

post_max_size = 64M

 

Starten Sie DDEV nach den Änderungen neu:

ddev restart

Angemessene Speicher- und Ausführungsgrenzen helfen, Zeitüberschreitungen und Installationsfehler zu vermeiden.

Optimierung der Docker-Leistung

Die Docker-Ressourcenzuteilung wirkt sich direkt auf die TYPO3-Leistung aus.

Berücksichtigen Sie die folgenden Optimierungen:

  • Weisen Sie Docker ausreichend RAM und CPU in den Einstellungen zu
  • Verwenden Sie SSD-Speicher für Projektdateien und Docker-Daten
  • Schließen Sie unnötige Container oder Anwendungen, die Ressourcen verbrauchen
  • Starten Sie Docker regelmäßig neu, um Ressourcenengpässe zu beseitigen
  • Lassen Sie unter macOS und klassischem Windows die Mutagen-Dateisynchronisierung aktiv; DDEV schaltet sie dort standardmäßig für schnellen Dateizugriff ein

Eine ordnungsgemäße Docker-Konfiguration sorgt für schnellere Container-Startzeiten und eine reibungslosere TYPO3-Betriebsweise während der Entwicklung.

Obwohl DDEV in erster Linie für die lokale Entwicklung konzipiert ist, lässt es sich auch in Remote-Hosting-Umgebungen und automatisierte Bereitstellungsworkflows integrieren. 

Dadurch eignet es sich hervorragend zum Synchronisieren von Daten, zum Testen von Änderungen und zum Gewährleisten der Konsistenz zwischen lokalen und Remote-Setups.

Zu den wichtigsten Funktionen gehören:

  • Daten aus Remote-Umgebungen abrufen:

Mithilfe anbieterspezifischer Integrationen können Sie Datenbanken und Dateien aus Staging- oder Produktionsumgebungen in Ihr lokales Setup importieren.
ddev pull

  • Daten an Remote-Umgebungen übertragen:

In unterstützten Setups können lokale Datenbank- oder Dateiänderungen zum Testen oder zur Bereitstellung zurück in eine Remote-Umgebung übertragen werden.
ddev push

  • CI/CD-Integration:

DDEV kann in automatisierten Pipelines eingesetzt werden, die in temporären (ephemeren) Docker-Umgebungen laufen. Dies ermöglicht reproduzierbare Builds, automatisierte Tests und konsistente Bereitstellungsprozesse teamübergreifend.

Durch die Überbrückung der lokalen Entwicklung mit Staging- oder Produktionssystemen hilft DDEV dabei, die Übereinstimmung zwischen den Umgebungen aufrechtzuerhalten und gleichzeitig Konfigurationsabweichungen zu reduzieren.

Wie nutzen Sie AI-Coding-Assistenten mit einem TYPO3-Projekt in DDEV?

Ein AI-Assistent oder Coding-Agent arbeitet am zuverlässigsten, wenn er dieselben DDEV-Befehle nutzt wie Sie und die offizielle Dokumentation liest. Geben Sie ihm die Doku von DDEV und TYPO3 als Markdown und lassen Sie ihn Befehle über ddev statt über ein lokales PHP ausführen.

  • Doku für den Agenten: DDEV stellt seine Dokumentation für AI-Assistenten als llms.txt (mit Links auf eine Markdown-Fassung jeder Seite) und als llms-full.txt (alle Seiten in einer Datei) bereit. Die Seiten der TYPO3-Dokumentation bieten einen Link „View as Markdown“.
  • Gleiche Befehle für Mensch und Agent: Lassen Sie den Agenten ddev composer, ddev typo3 und ddev exec verwenden, damit PHP- und Datenbankversion zum Projekt passen.
  • URLs für Skripte: ddev launch --print-url gibt die URL der Website aus, statt einen Browser zu öffnen, praktisch in Terminals, Containern und CI.
  • Gefahrlos testen: Legen Sie mit ddev snapshot eine Sicherung an, bevor ein Agent die Datenbank ändert, und stellen Sie sie mit ddev snapshot restore wieder her.

Wenn Sie einen AI-Assistenten direkt an das TYPO3-Backend anbinden, testen Sie das zuerst in der lokalen DDEV-Website. Unser Beitrag MCP in der Praxis für TYPO3 zeigt, wie das mit echten Aufgaben funktioniert.

DDEV bietet eine zuverlässige und reproduzierbare Umgebung für die lokale TYPO3-Entwicklung. Auch die AI Foundation für TYPO3 sowie verbundene Anbieter, Prompts und Berechtigungen sollten zunächst lokal oder auf einer Staging-Umgebung getestet werden.

Mit nur wenigen Befehlen können Sie eine voll funktionsfähige TYPO3-Umgebung einrichten, einheitliche Konfigurationen im gesamten Team nutzen, effizient debuggen und Entwicklungsabläufe beschleunigen.

Sein containerbasierter Ansatz gewährleistet Zuverlässigkeit, Reproduzierbarkeit und Flexibilität und macht DDEV zu einer praktischen Wahl für moderne TYPO3-Projekte jeder Größe. Die Installation und Nutzung von DDEV ist unkompliziert, sodass sich Entwickler auf das Erstellen und Testen konzentrieren können, anstatt sich um die Verwaltung der Infrastruktur kümmern zu müssen.

Weiterführend (englisch): Installing TYPO3 with DDEV (TYPO3-Doku), DDEV CMS Quickstarts und die DDEV-Befehlsreferenz. Sobald die Basisinstallation läuft, wählen Sie ein Design aus unseren TYPO3 Templates und binden es per Composer ein.

Kostenlose TYPO3-Leitfäden mit Excel-Vorlage

Laden Sie kostenlose TYPO3-Leitfäden zu Upgrade, EU AI Act, Barrierefreiheit und MCP, jeweils als PDF mit Excel-Arbeitsblatt.

Zu den kostenlosen TYPO3-Leitfäden

Ja. Docker ist erforderlich, da DDEV Container verwendet, um den Webserver, die PHP-Laufzeit und die Datenbank auszuführen. Ohne Docker kann DDEV die TYPO3-Umgebung nicht starten.

Verwenden Sie die neueste Long-Term Support (LTS)-Version von TYPO3. LTS-Versionen bieten erweiterte Sicherheitsupdates, Stabilität und Kompatibilität mit modernen PHP-Versionen, was sie ideal für neue Projekte macht.

DDEV stellt automatisch eine Datenbank mit den Standard-Anmeldeinformationen bereit:

  • Host: db
  • Datenbank: db
  • Benutzername: db
  • Passwort: db

Diese Werte funktionieren in der Regel sofort während des TYPO3 Installationsassistenten.

Ja. Sie können DDEV im bestehenden Projektverzeichnis konfigurieren, Abhängigkeiten installieren (falls Composer verwendet wird) und die Projektdatenbank importieren. Nach der Konfiguration wird die Seite lokal innerhalb der DDEV-Umgebung ausgeführt.

Leistungsprobleme werden normalerweise durch unzureichende Systemressourcen, aktiviertes Xdebug oder eine niedrige Docker-Speicherzuweisung verursacht. Das Deaktivieren von Xdebug, wenn kein Debugging erforderlich ist, und das Erhöhen der Docker-Ressourcen verbessern normalerweise die Geschwindigkeit.

Öffnen Sie die Projekt-URL gefolgt von /typo3, zum Beispiel:

 

https:// my-typo3-project(.)ddev(.)site / typo3

 

Loggen Sie sich mit den Administrator-Anmeldeinformationen ein, die während des Installationsassistenten erstellt wurden.

Kommen Sie mit Ihrer lokalen TYPO3-Umgebung nicht weiter? Senden Sie eine TYPO3 Support Anfrage.