Schritt für Schritt Anleitung für eine Joomla-Migration von Version 4.x auf 5.x
Die folgende Dokumentation enthält eine Schritt-für-Schritt-Anleitung, um eine Joomla 4.x Webseite auf Joomla 5.x zu migrieren. Zwar gibt es hunderte von verschiedenen Szenarien, hier wird die grundlegende Vorgehensweise beschrieben.
1. Vorbereitung
1.1. Systemanforderungen prüfen
Prüfen Sie die Mindestanforderungen für Joomla 5:
| Komponente | Mindestanforderung Joomla 5 |
|---|---|
| PHP | 8.1.0 oder höher |
| MySQL | 8.0.13+ oder MariaDB 10.4+ |
| Webserver | Apache 2.4+, Nginx, IIS |
| Erweiterungen | Kompatibel mit Joomla 5 |
1.2. Erweiterungen prüfen
- Liste aller installierten Plugins, Module, Komponenten und Templates erstellen
- Kompatibilität mit Joomla 5 prüfen
- Alternativen für inkompatible Erweiterungen notieren
1.3. Backup erstellen
- Dateien sichern (inkl. Template- und Medienordner)
- Datenbank sichern (z.B. via phpMyAdmin oder Kommandozeile)
- Backups auf Wiederherstellbarkeit testen
1.4. Testumgebung einrichten
- Joomla 4 Installation auf einen Staging-Server kopieren
- Migration ausschließlich in der Testumgebung durchführen
2. Vor der Migration
2.1. Joomla 4 aktualisieren
- Sicherstellen, dass Joomla 4 auf aktueller Version ist
- Alle Sicherheits- und Stabilitätsupdates installieren
2.2. Kompatibilitätsprüfung
- Joomla Update-Kompatibilitätstool verwenden
- Templates, Extensions und PHP-Version prüfen
2.3. Bereinigung
- Unnötige oder veraltete Extensions deinstallieren
- Unbenutzte Templates und Medien löschen
3. Migration durchführen
3.1. Update-Paket herunterladen
- Offizielle Joomla-Website besuchen und Joomla 5 Upgrade-Paket herunterladen
- Version wählen, die direkt aus Joomla 4 aktualisieren kann
3.2. Update über Joomla Admin
- Backup im Admin-Bereich erstellen
- System → Wartung → Joomla-Update
- Nach Updates suchen → Joomla 5 Upgrade → Installieren
- Installation abwarten, Seite nicht verlassen
3.3. Manuelles Update (falls Auto-Update fehlschlägt)
- Joomla 5 Paket lokal entpacken
- Dateien via FTP/SSH überschreiben
- Datenbank über System → Wartung → Datenbank → Prüfen & Reparieren aktualisieren
4. Nach der Migration
4.1. Überprüfung
- Frontend und Backend testen
- Seiten, Module, Komponenten prüfen
- Menüführung und Medienverlinkungen überprüfen
4.2. Erweiterungen aktualisieren
- Joomla 5-kompatible Versionen installieren
- Inkompatible Erweiterungen deaktivieren oder ersetzen
4.3. Templates anpassen
- Template auf korrekte Anzeige prüfen
- CSS/JS und Template Overrides ggf. anpassen
4.4. Caching und SEO
- Cache leeren
- SEO-Einstellungen und URLs prüfen
- Seitenladezeiten testen
4.5. Backup nach Migration
Endgültiges Backup der Joomla 5-Installation erstellen.
5. Checkliste für die Joomla Migration
| Schritt | Status |
|---|---|
| Systemanforderungen prüfen | |
| Erweiterungen auf Kompatibilität prüfen | |
| Joomla 4 aktualisieren | |
| Backup (Dateien + DB) erstellt | |
| Staging-Umgebung eingerichtet | |
| Unnötige Erweiterungen entfernt | |
| Joomla 5 Update-Paket heruntergeladen | |
| Migration durchgeführt (Admin oder manuell) | |
| Datenbank repariert | |
| Frontend und Backend getestet | |
| Extensions aktualisiert | |
| Templates angepasst | |
| SEO & Cache geprüft | |
| Endgültiges Backup erstellt |
