Typo3 Auf Lokalem Rechner Installieren

Berechnen Sie die optimalen Systemressourcen für Ihre lokale TYPO3-Installation

Komplette Anleitung: TYPO3 auf lokalem Rechner installieren (2024)

Die lokale Installation von TYPO3 ist ein essentieller Schritt für Entwickler, die mit diesem leistungsstarken Enterprise-CMS arbeiten möchten. Diese Anleitung führt Sie durch den gesamten Prozess – von der Vorbereitung Ihres Systems bis zur erfolgreichen Installation und Konfiguration.

1. Systemvoraussetzungen für TYPO3

Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass Ihr System die Mindestanforderungen erfüllt:

• Betriebssystem: Windows 10/11, macOS 12+ oder Linux (Ubuntu 20.04+ empfohlen)
• Webserver: Apache 2.4+ oder Nginx 1.20+
• PHP-Version: 8.1 oder 8.2 (je nach TYPO3-Version)
• Datenbank: MySQL 5.7+ oder MariaDB 10.4+
• RAM: Mindestens 2GB (4GB+ für größere Projekte empfohlen)
• Festplattenspeicher: 500MB+ für die Grundinstallation

TYPO3 Version	PHP-Version	Datenbank	Empfohlener RAM	Unterstützung bis
TYPO3 v12 (LTS)	8.1 – 8.2	MySQL 5.7+ / MariaDB 10.4+	2GB+	Oktober 2026
TYPO3 v11 (LTS)	7.4 – 8.1	MySQL 5.7+ / MariaDB 10.3+	1.5GB+	Oktober 2024
TYPO3 v10 (LTS)	7.2 – 7.4	MySQL 5.6+ / MariaDB 10.2+	1GB+	April 2023 (EOL)

2. Installationsmethoden im Vergleich

Es gibt mehrere Möglichkeiten, TYPO3 lokal zu installieren. Jede Methode hat ihre Vor- und Nachteile:

1. Docker (empfohlen für Entwickler):
   • Vorteile: Isolierte Umgebung, einfache Versionierung, plattformunabhängig
   • Nachteile: Höherer Einrichtungsaufwand, Ressourcenintensiv
   • Empfohlen für: Professionelle Entwicklung, Teamumgebungen
2. XAMPP/MAMP:
   • Vorteile: Einfache Einrichtung, gute Dokumentation
   • Nachteile: Weniger flexibel, mögliche Versionkonflikte
   • Empfohlen für: Einsteiger, einfache Projekte
3. Native Installation:
   • Vorteile: Maximale Performance, volle Kontrolle
   • Nachteile: Komplexe Einrichtung, systemweite Änderungen
   • Empfohlen für: Erfahrene Administratoren, Produktionsumgebungen

Methode	Einrichtungszeit	Ressourcenverbrauch	Flexibilität	Empfohlen für
Docker	30-60 Minuten	Mittel-Hoch	Sehr hoch	Profis, Teams
XAMPP/MAMP	10-20 Minuten	Niedrig-Mittel	Mittel	Einsteiger
Native	60+ Minuten	Variiert	Sehr hoch	Experten

3. Schritt-für-Schritt Anleitung: TYPO3 mit Docker installieren

Die Docker-Installation bietet die beste Balance zwischen Flexibilität und Einfachheit. Folgen Sie diesen Schritten:

1. Docker und Docker Compose installieren:
   • Laden Sie Docker Desktop für Ihr Betriebssystem herunter: https://www.docker.com
   • Installieren Sie die Anwendung und starten Sie den Docker-Dienst
   • Überprüfen Sie die Installation mit docker --version in der Kommandozeile
2. Projektverzeichnis erstellen:

   mkdir typo3-docker
   cd typo3-docker

3. docker-compose.yml erstellen:

   Erstellen Sie eine Datei mit folgendem Inhalt (für TYPO3 v12):

   version: '3.8'
   
   services:
     typo3:
       image: typo3:12-apache
       ports:
         - "8080:80"
       volumes:
         - ./typo3:/var/www/html
       environment:
         - TYPO3_CONTEXT=Development
         - TYPO3_DATABASE_HOST=db
         - TYPO3_DATABASE_NAME=typo3
         - TYPO3_DATABASE_USER=typo3
         - TYPO3_DATABASE_PASSWORD=typo3
       depends_on:
         - db
   
     db:
       image: mariadb:10.11
       environment:
         - MYSQL_ROOT_PASSWORD=root
         - MYSQL_DATABASE=typo3
         - MYSQL_USER=typo3
         - MYSQL_PASSWORD=typo3
       volumes:
         - ./mysql:/var/lib/mysql
   
     adminer:
       image: adminer
       ports:
         - "8081:8080"

4. Docker Container starten:

   docker-compose up -d

   Dieser Befehl lädt die notwendigen Images herunter und startet die Container.

5. TYPO3 Installation durchführen:
   • Öffnen Sie http://localhost:8080 in Ihrem Browser
   • Wählen Sie “TYPO3 installieren” im Installationsassistenten
   • Folgen Sie den Anweisungen zur Datenbankkonfiguration (Host: db, Benutzername/Passwort: typo3)
   • Erstellen Sie einen Admin-Benutzer und konfigurieren Sie die Grundeinstellungen
6. Adminer für Datenbankverwaltung:

   Sie können die Datenbank über http://localhost:8081 mit Adminer verwalten (Benutzername/Passwort: typo3).

4. TYPO3 mit XAMPP installieren

Für eine einfachere Installation können Sie XAMPP verwenden:

1. XAMPP herunterladen und installieren:
   • Laden Sie XAMPP von apachefriends.org herunter
   • Installieren Sie die Version mit PHP 8.1 oder 8.2
   • Starten Sie Apache und MySQL über das XAMPP Control Panel
2. TYPO3 herunterladen:
   • Laden Sie die aktuelle TYPO3-Version von get.typo3.org herunter
   • Entpacken Sie das Archiv in den htdocs-Ordner von XAMPP
3. Datenbank erstellen:
   • Öffnen Sie phpMyAdmin über http://localhost/phpmyadmin
   • Erstellen Sie eine neue Datenbank (z.B. “typo3”) mit UTF8-Unicode-CI Sortierung
4. Installation durchführen:
   • Öffnen Sie http://localhost/typo3 in Ihrem Browser
   • Wählen Sie “TYPO3 installieren” und folgen Sie den Anweisungen
   • Geben Sie die Datenbankinformationen ein (Host: localhost, Benutzername: root, Passwort: [leer lassen])

5. Wichtige Konfigurationen nach der Installation

Nach der erfolgreichen Installation sollten Sie folgende Einstellungen vornehmen:

• Development-Konfiguration:
  • Setzen Sie im Install Tool unter “Configuration Presets” den Modus auf “Development”
  • Aktivieren Sie das Debugging und die Fehlerausgabe für die Entwicklung
• Benutzerrechte:
  • Erstellen Sie zusätzliche Backend-Benutzer mit appropriate Rechten
  • Konfigurieren Sie Benutzergruppen für verschiedene Rollen (Redakteure, Administratoren)
• Sicherheitseinstellungen:
  • Aktivieren Sie die “Force HTTPS”-Option wenn verfügbar
  • Setzen Sie starke Passwörter für alle Benutzerkonten
  • Konfigurieren Sie die Dateiberechtigungen gemäß den TYPO3-Empfehlungen
• Performance-Optimierung:
  • Aktivieren Sie das Caching-System
  • Konfigurieren Sie die OPcache-Einstellungen in der php.ini
  • Optimieren Sie die Datenbanktabellen regelmäßig

6. Häufige Probleme und Lösungen

Bei der lokalen Installation können verschiedene Probleme auftreten. Hier sind die häufigsten und ihre Lösungen:

1. Fehlende PHP-Erweiterungen:

   TYPO3 benötigt bestimmte PHP-Erweiterungen wie intl, gd und mbstring.

   • Lösung für Docker: Passen Sie die Dockerfile an oder installieren Sie die Erweiterungen im laufenden Container
   • Lösung für XAMPP: Bearbeiten Sie die php.ini-Datei und entfernen Sie das Semikolon vor den benötigten Erweiterungen
2. Datenbankverbindungsfehler:

   Häufig durch falsche Zugangsdaten oder nicht gestarteten Datenbankdienst.

   • Überprüfen Sie die Datenbank-Zugangsdaten in der LocalConfiguration.php
   • Stellen Sie sicher, dass der Datenbank-Container (Docker) oder MySQL-Dienst (XAMPP) läuft
3. Berechtigungsprobleme:

   TYPO3 benötigt Schreibrechte für bestimmte Verzeichnisse.

   • Lösung für Docker: Passen Sie die Berechtigungen in der docker-compose.yml an
   • Lösung für native Installation:

     chmod -R 775 typo3temp var/uploads fileadmin/user_upload

4. Langsame Performance:

   Lokale Installationen können langsam sein, besonders mit Docker.

   • Erhöhen Sie die zugewiesenen Ressourcen in Docker Desktop (mind. 4GB RAM)
   • Aktivieren Sie OPcache in der php.ini
   • Deaktivieren Sie nicht benötigte TYPO3-Erweiterungen

7. Nützliche Erweiterungen für die lokale Entwicklung

Diese TYPO3-Erweiterungen sind besonders hilfreich für die lokale Entwicklung:

• Mask: Ermöglicht die einfache Erstellung von Inhaltslementen mit benutzerdefinierten Feldern
• News: Beliebte Erweiterung für die Verwaltung von Nachrichten/Artikeln
• RealURL/RouteEnhancers: Für sprechende URLs in der Entwicklungsumgebung
• DebugBar: Zeigt Debug-Informationen direkt im Frontend an
• TYPO3 Console: Ermöglicht die Ausführung von CLI-Befehlen über das Backend
• Fluid Styled Content: Moderne Template-Engine für TYPO3
• Bootstrap Package: Integriert Bootstrap 5 in TYPO3 für modernes Frontend-Design

8. Best Practices für die lokale TYPO3-Entwicklung

Folgen Sie diesen Empfehlungen für eine effiziente lokale Entwicklung:

1. Versionskontrolle:
   • Nutzen Sie Git für die Versionskontrolle Ihres Projekts
   • Erstellen Sie eine .gitignore-Datei, die temporäre Dateien ausschließt
   • Committen Sie regelmäßig mit aussagekräftigen Commit-Messages
2. Datenbank-Management:
   • Nutzen Sie Tools wie Adminer oder DBeaver für die Datenbankverwaltung
   • Erstellen Sie regelmäßig Datenbank-Backups
   • Nutzen Sie für größere Projekte Migrations-Tools wie Doctrine
3. Umgebungsmanagement:
   • Nutzen Sie unterschiedliche Konfigurationen für Entwicklung, Testing und Produktion
   • Verwenden Sie Environment-Variablen für sensible Daten
   • Nutzen Sie Docker-Compose Override-Dateien für umgebungsspezifische Einstellungen
4. Testing:
   • Richten Sie automatisierte Tests mit PHPUnit ein
   • Nutzen Sie Behat für Behavior-Driven Development
   • Testen Sie regelmäßig in verschiedenen Browsern
5. Dokumentation:
   • Dokumentieren Sie Ihre Konfigurationen und Anpassungen
   • Nutzen Sie Tools wie Swagger für API-Dokumentation
   • Erstellen Sie eine README.md mit Setup-Anweisungen für neue Teammitglieder

9. Migration von lokal zu Live-System

Wenn Ihr Projekt bereit für die Live-Umgebung ist, folgen Sie diesen Schritten:

1. Datenbank exportieren:
   • Nutzen Sie phpMyAdmin oder die Kommandozeile:

     mysqldump -u [benutzername] -p [datenbankname] > typo3_database.sql

   • Bereinigen Sie die Datenbank von Entwicklungsspezifischen Daten
2. Dateien kopieren:
   • Kopieren Sie alle Dateien außer typo3temp/ und var/ auf den Live-Server
   • Stellen Sie sicher, dass die Dateiberechtigungen auf dem Live-System korrekt gesetzt sind
3. Konfiguration anpassen:
   • Passen Sie die LocalConfiguration.php und .env-Dateien an
   • Ändern Sie die Datenbank-Zugangsdaten für das Live-System
   • Setzen Sie den Kontext auf “Production”
4. Domain-Konfiguration:
   • Passen Sie die config.yaml oder AdditionalConfiguration.php an
   • Konfigurieren Sie die Domain-Einstellungen im Install Tool
   • Richten Sie SSL-Zertifikate ein
5. Testen:
   • Führen Sie einen vollständigen Funktionstest durch
   • Überprüfen Sie alle Links und Ressourcen
   • Testen Sie die Performance unter Last

10. Sicherheitsaspekte für lokale Installationen

Auch lokale Installationen sollten sicher konfiguriert werden:

• Zugangsschutz:
  • Schützen Sie Ihr lokales Entwicklungssystem mit einem Passwort
  • Nutzen Sie eine Firewall, um unberechtigten Zugriff zu verhindern
• Sichere Passwörter:
  • Verwenden Sie starke Passwörter für alle lokalen Dienste (Datenbank, TYPO3-Backend)
  • Nutzen Sie einen Passwort-Manager für lokale Credentials
• Regelmäßige Updates:
  • Aktualisieren Sie regelmäßig TYPO3, PHP und alle Erweiterungen
  • Nutzen Sie den TYPO3 Core Updater für einfache Updates
• Datenverschlüsselung:
  • Verschlüsseln Sie sensible Daten in Ihrer lokalen Datenbank
  • Nutzen Sie HTTPS auch in der Entwicklungsumgebung (z.B. mit mkcert)
• Backup-Strategie:
  • Erstellen Sie regelmäßige Backups Ihrer lokalen Installation
  • Nutzen Sie Tools wie docker commit für Docker-Installationen
  • Speichern Sie Backups an einem sicheren Ort

Offizielle Ressourcen und weiterführende Links:

• TYPO3 Dokumentation: https://docs.typo3.org – Die offizielle TYPO3-Dokumentation mit detaillierten Installationsanweisungen und Best Practices.
• TYPO3 Docker Images: https://hub.docker.com/_/typo3 – Offizielle Docker-Images für TYPO3 mit verschiedenen Konfigurationen.
• Sicherheitsempfehlungen des BSI: https://www.bsi.bund.de – Sicherheitsrichtlinien des Bundesamts für Sicherheit in der Informationstechnik (BSI) für CMS-Systeme.
• PHP Dokumentation: https://www.php.net/manual/de/ – Offizielle PHP-Dokumentation mit Informationen zu benötigten Erweiterungen und Konfigurationen.
• MariaDB Dokumentation: https://mariadb.com/kb/en/ – Umfassende Dokumentation zu MariaDB für die Datenbankkonfiguration.

11. Performance-Optimierung für lokale Installationen

Lokale TYPO3-Installationen können langsam sein. Diese Tipps helfen, die Performance zu verbessern:

• OPcache aktivieren:

  OPcache beschleunigt PHP deutlich durch das Cachen von kompiliertem Bytecode.

  [OPcache]
  zend_extension=opcache
  opcache.enable=1
  opcache.memory_consumption=256
  opcache.interned_strings_buffer=16
  opcache.max_accelerated_files=4000
  opcache.revalidate_freq=60
  opcache.fast_shutdown=1

• Docker-Ressourcen anpassen:

  In Docker Desktop können Sie die zugewiesenen Ressourcen erhöhen:

  • CPU: Mindestens 2 Kerne
  • RAM: Mindestens 4GB (8GB für große Projekte)
  • Swap: 1GB
  • Festplatte: Mindestens 20GB
• TYPO3-Caching optimieren:
  • Aktivieren Sie das File-Caching in den TYPO3-Einstellungen
  • Konfigurieren Sie Redis oder Memcached für das Session-Handling
  • Deaktivieren Sie nicht benötigte Caching-Frameworks
• Datenbank optimieren:
  • Führen Sie regelmäßig OPTIMIZE TABLE aus
  • Nutzen Sie InnoDB als Speicher-Engine
  • Konfigurieren Sie den MySQL-Query-Cache
• Frontend-Performance:
  • Kombinieren und komprimieren Sie CSS/JS-Dateien
  • Aktivieren Sie die GZIP-Komprimierung im Webserver
  • Nutzen Sie Browser-Caching für statische Ressourcen

12. Erweitere Konfigurationen für Fortgeschrittene

Für erfahrene Entwickler bieten sich diese erweiterten Konfigurationen an:

• Multi-Site Setup:

  Konfigurieren Sie mehrere TYPO3-Instanzen in einer Docker-Umgebung:

  version: '3.8'
  
  services:
    typo3-site1:
      image: typo3:12-apache
      ports:
        - "8080:80"
      volumes:
        - ./site1:/var/www/html
      environment:
        - VIRTUAL_HOST=site1.typo3.docker
        - TYPO3_DATABASE_NAME=typo3_site1
  
    typo3-site2:
      image: typo3:12-apache
      ports:
        - "8081:80"
      volumes:
        - ./site2:/var/www/html
      environment:
        - VIRTUAL_HOST=site2.typo3.docker
        - TYPO3_DATABASE_NAME=typo3_site2
  
    db:
      image: mariadb:10.11
      environment:
        - MYSQL_ROOT_PASSWORD=root
      volumes:
        - ./mysql:/var/lib/mysql
  
    proxy:
      image: jwilder/nginx-proxy
      ports:
        - "80:80"
      volumes:
        - /var/run/docker.sock:/tmp/docker.sock

• CI/CD Integration:

  Integrieren Sie Ihre lokale Entwicklung in eine CI/CD-Pipeline:

  name: TYPO3 CI
  
  on: [push]
  
  jobs:
    test:
      runs-on: ubuntu-latest
      services:
        mysql:
          image: mariadb:10.11
          env:
            MYSQL_ROOT_PASSWORD: root
            MYSQL_DATABASE: typo3
          ports:
            - 3306:3306
          options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
  
      steps:
      - uses: actions/checkout@v2
  
      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.1'
          extensions: mbstring, intl, gd, mysql, zip
  
      - name: Install dependencies
        run: composer install
  
      - name: Run tests
        run: ./vendor/bin/phpunit

• Debugging mit Xdebug:

  Konfigurieren Sie Xdebug für erweiterte Debugging-Möglichkeiten:

  [Xdebug]
  zend_extension=xdebug
  xdebug.mode=debug
  xdebug.start_with_request=yes
  xdebug.client_host=host.docker.internal
  xdebug.client_port=9003
  xdebug.idekey=VSCODE
  xdebug.max_nesting_level=256

13. Troubleshooting Guide

Wenn Sie auf Probleme stoßen, helfen diese erweiterte Troubleshooting-Schritte:

1. Log-Dateien analysieren:
   • TYPO3-Logs: var/log/typo3_*.log
   • Apache-Logs: logs/access.log und error.log
   • PHP-Logs: Abhängig von der php.ini-Konfiguration
   • Docker-Logs: docker logs [container-name]
2. Datenbank-Probleme diagnostizieren:
   • Überprüfen Sie die Datenbankverbindung mit:

     mysql -u typo3 -p -h db typo3

   • Testen Sie die Datenbank mit einfachen Abfragen
   • Überprüfen Sie die MySQL-Error-Logs
3. PHP-Konfiguration prüfen:
   • Erstellen Sie eine info.php-Datei:

     <?php phpinfo(); ?>

   • Überprüfen Sie die geladenen Erweiterungen
   • Vergleichen Sie mit den TYPO3-Systemanforderungen
4. Docker-spezifische Probleme:
   • Überprüfen Sie laufende Container: docker ps -a
   • Zeigen Sie Container-Logs an: docker logs [container-id]
   • Starten Sie Container neu: docker-compose restart
   • Setzen Sie Container zurück: docker-compose down -v (Vorsicht: Datenverlust!)
5. Netzwerk-Probleme:
   • Überprüfen Sie die Port-Belegung: netstat -tuln (Linux/macOS) oder netstat -ano (Windows)
   • Testen Sie die Verbindung zu Datenbank-Containern:

     docker exec -it [db-container] mysql -u typo3 -p typo3

   • Überprüfen Sie die Docker-Netzwerkkonfiguration: docker network inspect [network-name]

14. Zukunftssichere lokale Entwicklung mit TYPO3

Die TYPO3-Entwicklung schreitet schnell voran. Diese Trends sollten Sie für Ihre lokale Entwicklung im Blick behalten:

• TYPO3 v13 Vorbereitung:

  TYPO3 v13 (geplant für 2024) wird neue Anforderungen stellen:

  • PHP 8.2+ wird erforderlich sein
  • Neue Symfony-Komponenten werden integriert
  • Verbesserte API-First-Ansätze
• Headless TYPO3:

  Für Headless-CMS-Szenarien:

  • Konfigurieren Sie die API-Endpunkte in Ihrer lokalen Installation
  • Testen Sie mit Tools wie Postman oder Insomnia
  • Nutzen Sie die TYPO3 Core API für benutzerdefinierte Endpunkte
• Cloud-native Entwicklung:

  Bereiten Sie Ihre lokale Entwicklung auf Cloud-Deployments vor:

  • Nutzen Sie Docker mit Kubernetes-kompatiblen Konfigurationen
  • Implementieren Sie 12-Factor-App-Prinzipien
  • Testen Sie Skalierbarkeit mit Docker Swarm oder lokalem Kubernetes (Minikube)
• Automatisierte Testing-Strategien:

  Erweitern Sie Ihre lokale Entwicklung um umfassende Tests:

  • Implementieren Sie Unit-, Functional- und Acceptance-Tests
  • Nutzen Sie Codeception für End-to-End-Tests
  • Integrieren Sie statische Code-Analyse mit PHPStan oder Psalm
• DevOps-Integration:

  Verkürzen Sie den Entwicklungszyklus mit DevOps-Praktiken:

  • Nutzen Sie Infrastructure-as-Code (IaC) mit Terraform oder Ansible
  • Implementieren Sie GitHooks für automatisierte Qualitätschecks
  • Richten Sie lokale Monitoring-Tools wie Prometheus ein

Akademische Ressourcen zu TYPO3 und Webentwicklung:

• Technische Universität München – Webtechnologien: https://www.in.tum.de – Forschung und Lehre zu modernen Web-CMS und Enterprise-Lösungen.
• Hochschule für Technik und Wirtschaft Berlin – Content Management: https://www.htw-berlin.de – Studiengänge und Forschungsprojekte zu CMS-Systemen und digitaler Transformation.
• Massachusetts Institute of Technology – Web Development: https://ocw.mit.edu – Offene Kursmaterialien zu modernen Webtechnologien und Software-Architektur.