Migration zu Next.js / Astro in Bielefeld

Bielefeld ist mit 331.419 Einwohnern (Stand 31.12.2025) die größte Stadt in Ostwestfalen-Lippe. Die Wirtschaftsentwicklungsgesellschaft WEGE nennt auf ihrer Website einen gesunden Branchenmix und wendet sich ausdrücklich an Handwerksbetriebe, Produktions- und Dienstleistungsunternehmen. Dort stehen viele Websites, die vor Jahren in Joomla gebaut wurden und seitdem gewachsen sind: Menüs, Kategorien, ein Kontaktformular, eine Suche, ein paar Erweiterungen. Diese Seite beschreibt, wie ich so eine Joomla-Website auf Astro oder Next.js umziehe: was Sie über den Support Ihrer Version wissen müssen, was sich exportieren lässt und was an die Stelle der Erweiterungen tritt.

Ich bin Mariusz Szatkowski, arbeite allein und remote aus Gdynia und mit WordPress seit 2006. Abstimmung läuft schriftlich, Termine und Vor-Ort-Besuche gibt es nicht. Das Layout kommt von Ihnen, ich baue es nach. Bei einer Joomla-Seite ist das meist der bestehende Auftritt, den ich Seite für Seite nachbaue.

#Welche Joomla-Version läuft bei Ihnen und wie lange gibt es dafür Updates?

Die Roadmap auf developer.joomla.org führt derzeit Joomla 5 und Joomla 6 als unterstützte Hauptversionen. Die Termine, Stand 11.11.2026:

Die Zeilen zu Joomla 5 und 6 stammen aus der Roadmap des Joomla-Projekts, die PHP-Angaben aus den technischen Anforderungen im Handbuch, die Zeile zu Joomla 3 aus der archivierten Handbuchversion 4.4. Für Joomla 4 führt die Roadmap keine Supportzeit mehr auf, das Handbuch zu 4.4 ist als archiviert markiert.

Was das praktisch heißt: Läuft Ihre Seite auf Joomla 3 oder 4, bekommt sie keine Sicherheitsfixes des Projekts mehr, ob Sie sie ablösen oder auf Joomla 5 oder 6 heben. Läuft sie auf Joomla 5, endet der Bugfix-Zeitraum seit dem 13. Oktober 2026, Sicherheitsfixes laufen noch knapp ein Jahr. Joomla 6 gibt Ihnen Zeit bis Oktober 2029. Daraus folgt keine Pflicht zum Wechsel auf Astro oder Next.js. Ein Upgrade innerhalb von Joomla ist ein legitimer Weg, wenn die Redaktion zufrieden ist und die Erweiterungen mitziehen. Eine Migration lohnt sich, wenn Sie ohnehin an die Erweiterungen müssen und ein Frontend ohne Datenbank und PHP pro Aufruf wollen.

#Was sich aus Joomla exportieren lässt

Die Joomla-Kernfunktionen bestimmen, welche Felder ich mitnehmen muss. Die Übersicht der Kernfunktionen nennt unter anderem Kategorien ohne Tiefenbegrenzung, Tags, Menüverwaltung, Weiterleitungen, Contacts mit Kontaktformularen, benutzerdefinierte Felder und mehrsprachige Inhalte mit Sprachzuordnungen. Jedes davon wird zu einer eigenen Zeile in der Übernahmeliste:

• Artikel: Seit Joomla 4 gibt es eine Web Services API. Artikel lassen sich unter content/articles mit einem API-Token im Header X-Joomla-Token auslesen, einzeln oder pro Kategorie. Daraus erzeuge ich Markdown-Dateien oder Einträge für ein Headless-CMS. Der Token gehört einem eigenen Benutzer mit den nötigen Rechten und wird nach dem Export gelöscht.
• Alias und Meta-Daten: Laut Kernfunktionen bekommt jeder Artikel und jeder Menüpunkt einen Alias, und jeder Menüpunkt kann eigene Meta-Description und Robots-Angaben haben. Beides übernehme ich unverändert in die neuen Dateien, bevor ich irgendetwas optimiere.
• Menüs: Die Menüstruktur lese ich aus dem Menü-Manager und gleiche sie mit einem Crawl der Live-Seite ab. Der Crawl zeigt, welche URLs wirklich ausgeliefert werden, mit oder ohne index.php, mit Parametern oder als saubere Aliase.
• Tags, Kategorien, benutzerdefinierte Felder: Sie werden zu Feldern und Collections. Wo Joomla einem Artikel ein Zusatzfeld mitgibt, bekommt die Collection ein typisiertes Feld.
• Sprachversionen: Sprachzuordnungen werden zu hreflang-Gruppen. Fehlt eine Übersetzung, entsteht kein leerer Verweis.
• Medien: Bilder aus dem Medien-Manager ziehe ich in die neue Projektstruktur, mit festen Abmessungen und Alternativtexten.

Foto: Bielibob, CC BY-SA 4.0, Wikimedia Commons.

Alles, was die API nicht liefert, hole ich aus einem Datenbankexport: Daten von Erweiterungen, Formulareinsendungen, Newsletter-Listen. Welche Joomla-Daten danach gelöscht werden und wann, legen Sie fest. Ich lösche nichts ohne Ihre schriftliche Freigabe.

#Was an die Stelle der Erweiterungen tritt

Jede Drittanbieter-Erweiterung bekommt in der Bestandsaufnahme eine Zeile: Zweck, gespeicherte Daten, Ersatz oder Streichung. Für die üblichen Funktionen gilt:

Formulare. Laut Astro-Dokumentation lassen sich Actions über ein HTML-Formular aufrufen, die Seite muss dann aber on demand gerendert werden, nicht vorab als statisches HTML. Das heißt: Eine sonst statische Astro-Seite braucht für das Formular einen Adapter und einen Server. Alternative ist ein externer Formular-Dienst, den Sie dann in Ihre Datenschutzhinweise aufnehmen. In Next.js sind Server Actions der vorgesehene Weg, und die Dokumentation verlangt, Authentifizierung und Berechtigung in jeder Action selbst zu prüfen. Ich teste jedes Formular mit echten Einsendungen bis ins Postfach, bevor die alte Seite abgeschaltet wird.

Suche. Pagefind ist nach eigener Beschreibung eine vollständig statische Suchbibliothek, die mit jedem statischen HTML-Output arbeitet. Für eine Seite mit einigen Hundert Artikeln ist das meist die einfachste Lösung, ohne Suchserver und ohne weiteren Dienst.

Weiterleitungen. Die Astro-Konfiguration kennt eine Option redirects: Für GET-Anfragen liefert sie in Produktion einen 301, für andere Methoden einen 308. Next.js nutzt in redirects bei permanent: true den Statuscode 308. Beides sind dauerhafte Weiterleitungen im Sinne der Google-Dokumentation.

Newsletter. Hier gibt es eine Besonderheit in Nordrhein-Westfalen: Das Verwaltungsgericht Düsseldorf hat nach einer Mitteilung der LDI NRW vom 05.10.2026 entschieden, dass Unternehmen die Einwilligung in Werbemails nachweisen müssen. IP-Adresse und Zeitstempel des Double-Opt-in reichten dem Gericht nicht, es verlangte etwa eine Bestätigungsmail. Das Urteil ist laut LDI NRW rechtskräftig. Wenn Ihre Joomla-Seite Newsletter-Empfänger über eine Erweiterung sammelt, exportiere ich die Einwilligungsnachweise zusammen mit den Adressen und halte fest, was die alte Erweiterung gespeichert hat. Welche Nachweise für Ihren Fall genügen, klären Sie mit Ihrem Datenschutzbeauftragten.

#URLs, Weiterleitungen und die Zeit danach

Google beschreibt in der Dokumentation Site Moves and Migrations den Ablauf, an den ich mich halte: neue Seite vorbereiten und testen, eine Zuordnung von alten zu neuen URLs erstellen, den Server so konfigurieren, dass alte URLs auf die neuen weiterleiten, und danach den Traffic auf beiden Seiten beobachten. Dazu gehört auch der Hinweis, nur eine Sache auf einmal zu ändern.

Bei Joomla-Seiten sind die alten URLs oft uneinheitlich, weil sich Menüstruktur und Aliase über die Jahre geändert haben. Aus Crawl, Sitemap und Search Console entsteht eine Tabelle: alte URL, neue URL, Statuscode, Canonical. Jede Zeile bekommt ein genaues Ziel, keine pauschale Weiterleitung auf die Startseite. Vor dem Go-live läuft die Liste gegen die Staging-Umgebung: Jede alte URL muss auf ein Ziel mit Status 200 führen, ohne Kette. Danach reiche ich die neue Sitemap ein und beobachte Indexierung und Core Web Vitals in der Search Console. Als Schwellen gelten die offiziellen Werte, also LCP bis 2,5 s, INP bis 200 ms, CLS bis 0,1. Ein Versprechen, dass Rankings unverändert bleiben, gebe ich nicht. Ich messe vorher und nachher und benenne, was sich verschoben hat.

#Recht in Nordrhein-Westfalen: DDG, TDDDG und LDI NRW

Drei Punkte betreffen die Migration direkt:

• Impressum nach § 5 DDG. Die Pflichtangaben müssen leicht erkennbar, unmittelbar erreichbar und ständig verfügbar sein. Das Impressum aus Joomla ziehe ich als Erstes um und prüfe, ob es von jeder Seite des neuen Auftritts erreichbar ist.
• Endgeräte-Zugriff nach § 25 TDDDG. Speichern und Auslesen von Informationen auf dem Endgerät braucht grundsätzlich eine Einwilligung, es sei denn, es ist unbedingt erforderlich, damit ein ausdrücklich gewünschter digitaler Dienst bereitgestellt werden kann. Beim Umzug fällt auf, was die Joomla-Seite alles nachlud. Ich nehme in den Neuaufbau nur auf, was Sie bewusst behalten wollen.
• Datenschutzhinweise. Die Landesbeauftragte für Datenschutz und Informationsfreiheit NRW (LDI NRW) stellt ein Muster für Datenschutzhinweise für einfache Websites bereit und schreibt dazu, dass die Erklärung ergänzt werden muss, wenn etwa Cookies, ein Kontaktformular, Kommentarfunktionen oder Social-Media-Plugins eingesetzt werden. Der Link muss von jeder einzelnen Seite mit einem Klick erreichbar sein. Wenn das neue Formular anders arbeitet als das alte, ändert sich Ihre Erklärung. Ich liefere Ihnen eine Liste der eingesetzten Komponenten und der Daten, die sie verarbeiten. Die Formulierung bleibt bei Ihnen oder Ihrem Datenschutzbeauftragten.

Ob Ihr Angebot unter das Barrierefreiheitsstärkungsgesetz fällt, ist eine eigene Frage. Gestaltung und Layout bringen Sie mit, semantisches HTML und Tastaturbedienbarkeit setze ich im Neubau um.

#So läuft ein Joomla-Projekt mit mir

1. Schriftliche Anfrage. Sie schicken die URL, die Joomla-Version (zu finden im Backend unter System, Systeminformationen) und was die Seite leisten soll.
2. Bestandsaufnahme. Crawl, Liste der Erweiterungen mit Zweck und Daten, Liste der Formulare, URL-Karte.
3. Schriftlicher Umfang. Welche Seiten umziehen, was entfällt, Astro oder Next.js, Annahmen und was nicht dazugehört, etwa Grafikdesign und Texte.
4. Staging. Neues Frontend auf einer Testadresse, Export mit Stichproben, Formulartests, URL-Test.
5. Abnahme und Umstellung. Ihre Redaktion veröffentlicht einen Testbeitrag, dann folgt der Wechsel.
6. Wartungsoption. Das Repository liegt in Ihrem Account. Wartung ist optional, nicht Bedingung.

Was ich von Ihnen brauche: Zugang zum Joomla-Backend, bei Bedarf einen Datenbankexport, den Zugang zum Hosting und die Layoutvorgaben, wenn sich etwas ändern soll.

Checkliste vor dem Start, auch ohne mich nutzbar:

#Für wen in Bielefeld passt das?

Für Betriebe, deren Joomla-Seite überwiegend aus Artikeln, Leistungsbeschreibungen, Stellenanzeigen und einem Formular besteht. Astro passt dort, Next.js dann, wenn ein Login oder ein Konfigurator dazukommt. Was ich zu den beiden Frameworks selbst schreibe, steht auf den Seiten zur Astro-Entwicklung in Bielefeld und zur Next.js-Entwicklung in Bielefeld. Das allgemeine Vorgehen bei Migrationen beschreibt die Hauptseite zur Migration.

#Häufige Fragen

#Bis wann wird meine Joomla-Version unterstützt?

Nach der Roadmap des Joomla-Projekts liefen die regulären Bugfixes für Joomla 5 am 13. Oktober 2026 aus, Sicherheitsfixes gibt es bis zum 12. Oktober 2027. Für Joomla 6 enden die Bugfixes am 17. Oktober 2028 und die Sicherheitsfixes am 16. Oktober 2029. Joomla 3 ist seit dem 17. August 2023 ohne Support, der erweiterte LTS-Support endete am 17. Februar 2025.

#Wie komme ich an die Artikel meiner Joomla-Website?

Joomla bringt seit Version 4 eine Web Services API mit, über die sich Artikel am Endpunkt content/articles mit einem API-Token auslesen lassen. Daraus erzeuge ich Markdown-Dateien oder Einträge für ein Headless-CMS. Bei Joomla 3 oder gesperrter API lese ich dieselben Daten aus einem Datenbankexport.

#Was ersetzt das Joomla-Kontaktformular?

Bei Astro ein Astro Action, bei Next.js eine Server Action. Beide brauchen serverseitige Ausführung. Die Datenschutzhinweise müssen danach zum neuen Formular passen, denn die LDI NRW verlangt in ihrem Muster ausdrücklich eine Ergänzung, wenn ein Kontaktformular angeboten wird.

#Was passiert mit der Joomla-Suche?

Bei einer statisch erzeugten Seite setze ich eine Suche wie Pagefind ein. Sie indexiert das erzeugte HTML beim Build und liefert die Suche als statische Dateien aus, ohne eigenen Suchserver.

#Muss ich Impressum und Datenschutzerklärung anfassen?

Das Impressum muss nach § 5 DDG leicht erkennbar, unmittelbar erreichbar und ständig verfügbar sein, auch während der Umstellung. Die Datenschutzerklärung prüfen Sie nach dem Umzug gegen die neuen Komponenten, etwa Formular, Suche und eingebettete Dienste. Rechtsberatung ist das nicht, das gehört zu Ihrem Datenschutzbeauftragten oder einer Kanzlei.

#Kann Joomla als Backend bleiben?

Ja, wenn die Redaktion im vertrauten Backend weiterarbeiten soll. Das neue Frontend liest die Inhalte dann über die API. Der Preis dafür ist, dass Joomla weiter gepatcht werden muss. Bei Seiten, die sich selten ändern, empfehle ich Markdown im Repository.

#Schreiben Sie mir, wenn Joomla bei Ihnen ausläuft

Schicken Sie mir über das Kontaktformular die Adresse Ihrer Website, die Joomla-Version, falls bekannt, Ihr Ziel und einen Wunschtermin für die Umstellung. Ein Export aus der Search Console hilft, ist aber kein Muss. Ich antworte schriftlich an Werktagen mit einer ersten Einschätzung: Passt Astro oder Next.js, was würde ich im bestehenden System lassen, und welche Fragen sind offen. Diese erste Einschätzung ist kostenlos.