Install TYPO3 mit DDEV - in 8 Simple Steps

Richten Sie mit DDEV und Composer in nur wenigen Befehlen eine neue TYPO3 installation lokal ein. Dadurch wird eine vollständige Docker-basierte Entwicklungsumgebung erstellt und das TYPO3 Install ationstool in Ihrem Browser gestartet.

Schritt 1: Erstellen Sie ein Projektverzeichnis

mkdir my-typo3-project

cd my-typo3-project

Schritt 2: Konfigurieren Sie DDEV für TYPO3

ddev config --project-type=typo3 --docroot=public --create-docroot

Schritt 3: Starten Sie die DDEV-Umgebung

ddev start

Schritt 4: Installieren Sie TYPO3 über Composer

ddev ssh

composer create-project typo3/cms-base-distribution public

exit

Schritt 5: Starten Sie die Seite

ddev launch

Ihr Browser öffnet das TYPO3 Install Tool unter:

my-typo3-project.ddev.site

Folgen Sie dem On-Screen-Assistenten, um die Datenbank zu konfigurieren und Ihr Admin-Konto zu erstellen. Nach Abschluss haben Sie eine vollständig funktionierende lokale TYPO3-Instanz, die in DDEV ausgeführt wird.

Voraussetzungen: Docker und DDEV müssen installiert und ausgeführt werden, bevor Sie diese Befehle ausführen.

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 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.

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.

Bei der Einrichtung von TYPO3 mit DDEV ist es wichtig, die richtige PHP-Version auszuwählen, da jede TYPO3-Version bestimmte PHP-Bereiche unterstützt. DDEV ermöglicht es Ihnen, die PHP-Version pro Projekt zu konfigurieren, sodass es einfach ist, die Anforderungen von TYPO3 zu erfüllen.

PHP & TYPO3-Kompatibilität

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 v13 LTS die bevorzugte Option für neue Projekte, da sie moderne Funktionen, verbesserte Leistung und erweiterte Supportabdeckung bietet.

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
  • Docker Desktop für Windows oder macOS
  • Docker Engine für Linux
• DDEV CLI installiert

DDEV installieren (falls noch nicht installiert)

Sie können DDEV mit dem offiziellen Installationsskript installieren:

curl -fsSL ddev.com/install.sh | bash

Alternativ können Sie die für Ihr Betriebssystem geeignete Version aus dem offiziellen DDEV-Installationsleitfaden herunterladen.

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.

Nachdem DDEV für Ihr Projekt konfiguriert wurde, können Sie TYPO3 mit Composer installieren. Das Ausführen von Composer innerhalb des Containers stellt sicher, dass die korrekte PHP-Version und die Abhängigkeiten verwendet werden, die Ihren TYPO3-Anforderungen entsprechen.

Starten der DDEV-Umgebung

Initialisieren Sie die lokale Entwicklungsumgebung:

Dieser Befehl startet die erforderlichen Docker-Container, einschließlich:

• Web-Container
• Datenbank-Container (MariaDB)
• Unterstützende Dienste

Nach dem Start ist Ihre Projektumgebung bereit, Befehle zu akzeptieren und die Anwendung bereitzustellen.

Zugriff auf den Web-Container

Treten Sie in den laufenden Web-Container ein, um Composer-Befehle innerhalb der konfigurierten Umgebung auszuführen:

Sie befinden sich dann in der Container-Shell, typischerweise unter:

/var/www/html

Alle weiteren Installationsbefehle sollten von hier aus ausgeführt werden.

Erstellen des TYPO3-Projekts mit Composer

Verwenden Sie Composer, um die TYPO3-Basisdistribution herunterzuladen und zu installieren:

Dies installiert TYPO3 in das public/-Verzeichnis, welches das empfohlene Dokumentenstammverzeichnis für moderne Composer-basierte Setups ist.

Alternative:
Wenn Ihr Projekt eine andere Struktur verwendet, ersetzen Sie public durch den konfigurierten Docroot-Ordner.

Dieser Prozess lädt die TYPO3-Core-Dateien, die erforderlichen Abhängigkeiten und die Standard-Projektstruktur herunter.

Dateibesitz & Berechtigungen

DDEV verwaltet die Dateiberechtigungen in der Regel automatisch. Falls Sie jedoch auf Berechtigungsprobleme stoßen (z. B. nicht zugängliche Dateien oder Schreibfehler), passen Sie den Besitz außerhalb des Containers an:

exit  
ddev exec chown -R www-data:www-data /var/www/html/public

Die Gewährleistung des richtigen Besitzes ermöglicht es dem Webserver, Dateien ordnungsgemäß zu lesen und zu schreiben, was für die TYPO3-Installation und den Betrieb unerlässlich ist.

Nach Abschluss dieser Schritte werden die TYPO3-Core-Dateien installiert und sind bereit, über das Install Tool konfiguriert zu werden.

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

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

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

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

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

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

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.1”

router_http_port: “80”

router_https_port: “443”

webserver_type: apache-fpm

xdebug_enabled: false

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

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

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 --src=path/to/database.sql

Nach dem Import sollte TYPO3 den bestehenden Inhalt und die Konfiguration der Website erkennen.

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:

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

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 in der .ddev/config.yaml ein oder aus::

xdebug_enabled: false

Wenden Sie die Änderungen an, indem Sie die Umgebung neu starten:

ddev restart

Wenden Sie die Änderungen an, indem Sie die Umgebung neu starten:

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
• Auf Windows/macOS stellen Sie sicher, dass die Dateifreigabeeinstellungen Ihr Projektverzeichnis beinhalten

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

DDEV macht die manuelle Konfiguration von PHP, Webservern und Datenbanken für die lokale TYPO3-Entwicklung überflüssig. 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.

Viel Spaß bei der TYPO3-Entwicklung mit DDEV!