Manuel Killert
Ratgeber · TYPO3 · Umzug

TYPO3 umziehen — die Reihenfolge entscheidet.

Ein Umzug ist technisch kein Hexenwerk, aber er hat in TYPO3 mehr Stellschrauben als in anderen Systemen. Wer die Reihenfolge kennt, ist an einem Tag durch. Wer sie nicht kennt, sucht drei Tage nach fehlenden Bildern.

Referenzen ansehen →Projekt anfragen
Kurz gesagt

Nach dem Übertragen von Dateien und Datenbank sind fünf Schritte Pflicht, und zwar in dieser Reihenfolge: Konfiguration anpassen (Datenbankzugang), Caches leeren, Datenbankabgleich, Dateiindex neu aufbauen und Site-Konfiguration auf die neue Domain prüfen. Wird einer ausgelassen, entstehen Fehler, die nach ganz anderen Problemen aussehen — fehlende Seiten, leere Bilder, kaputte Listen.

Sofort-Hilfe

Website down oder gehackt? Schreib mir per WhatsApp oder E-Mail mit Domain und kurzer Beschreibung — ich melde mich in der Regel innerhalb weniger Stunden, auch am Wochenende, wenn es brennt. Zugangsdaten bitte nie in der ersten Nachricht, sondern erst nach Absprache über einen sicheren Weg.

Vorbereitung.

  1. Bestandsaufnahme: TYPO3-Version, PHP-Version, Datenbanktyp und -version, Installationsart.
  2. Vollständige Sicherung von Dateien und Datenbank, abgelegt außerhalb beider Server.
  3. Zeitfenster wählen: außerhalb der Hauptzeiten, nicht freitagnachmittags.
  4. Zeitabstand bei E-Mail klären: Liegen Postfächer beim selben Anbieter, hängen sie mit am Wechsel.
  5. Zugänge beschaffen: alter und neuer Server, Domain-Verwaltung.
  6. Lebenszeichen der Backups: Einmal testweise eine Datei zurückholen, bevor du dich darauf verlässt.

Punkt vier wird am häufigsten vergessen und sorgt für die unangenehmsten Überraschungen: Eine Domainumstellung kann den Mailempfang unterbrechen, wenn die Einträge nicht vorher abgeglichen wurden.

Zielumgebung prüfen.

Bevor etwas übertragen wird, muss der neue Server passen. TYPO3 ist anspruchsvoller als die meisten Systeme, und genau hier scheitern Umzüge auf günstige Pakete:

PunktWarum er zählt
PHP-VersionMuss zur TYPO3-Version passen, im Webserver und auf der Kommandozeile
PHP-ErweiterungenFehlt eine, äußert sich das als unzusammenhängender Fehler
BildbearbeitungsprogrammOhne das bleiben alle Bilder leer
Arbeitsspeicher und ZeitBackend und Upgrades brauchen mehr als das Frontend
SSH und ComposerBei modernen Installationen Pflicht
Zeitplan für HintergrundvorgängeSonst laufen Aufräumen und Indexierung nie

Die Details stehen in TYPO3-Hosting. Klär das schriftlich mit dem neuen Anbieter, bevor der Vertrag läuft — nicht hinterher.

Dateien und Datenbank übertragen.

Bei den Dateien gehören mit: das Installationsverzeichnis, die Dateiablage mit allen Inhalten und die Konfiguration. Nicht nötig sind Caches und verarbeitete Bilder — die werden neu erzeugt und machen die Übertragung nur unnötig groß. Bei Composer-Installationen reicht oft das Repository plus Dateiablage, weil die Abhängigkeiten auf dem Zielserver neu installiert werden.

Bei der Datenbank ist der Zeichensatz entscheidend. Exportiere bewusst mit der Kodierung, die die Installation nutzt, und importiere mit derselben. Wird das dem Zufall überlassen, hast du nach dem Umzug Zeichenmüll statt Umlauten — und das lässt sich nur durch einen erneuten Import beheben, nicht durch Umstellen der Anzeige (Datenbankfehler).

Bei großen Datenbanken bricht ein Import über die Weboberfläche gern ab. Dann führt der Weg über die Kommandozeile — dort greifen die Zeitgrenzen des Webservers nicht.

Konfiguration anpassen.

In der Systemkonfiguration stehen die Zugangsdaten zur Datenbank. Sie müssen auf die neue Umgebung zeigen: Name, Benutzer, Passwort, Host und gegebenenfalls Port. Der Host unterscheidet sich je Anbieter — mal der lokale Rechner, mal ein eigener Servername.

Prüfe bei der Gelegenheit zwei weitere Einstellungen, die nach einem Umzug oft nicht mehr passen: den hinterlegten Pfad zum Bildbearbeitungsprogramm und die Einstellungen für den Mailversand. Beides zeigt sonst auf eine Umgebung, die es nicht mehr gibt.

Die fünf Pflichtschritte.

  1. Konfiguration anpassen — ohne Datenbankzugang läuft gar nichts.
  2. Alle Caches leeren, am besten per FTP die Inhalte der Cache-Verzeichnisse entfernen (Cache leeren).
  3. Datenbankabgleich im Install-Tool ausführen, hinzufügende Änderungen zulassen.
  4. Dateiindex neu aufbauen — sonst zeigt TYPO3 auf Dateien, die es aus seiner Sicht nicht gibt.
  5. Site-Konfiguration prüfen und auf die tatsächliche Domain stellen.

Werden Schritt vier und fünf ausgelassen, entsteht genau das typische Bild nach einem Umzug: Die Startseite läuft, Unterseiten liefern 404, und Bilder fehlen flächendeckend (Seite nicht gefunden, Bilder fehlen).

Site-Konfiguration.

Sie legt fest, welche Domain zu welchem Teil des Seitenbaums gehört. Nach einem Umzug steht dort oft noch die alte Adresse — und TYPO3 findet den Einstiegspunkt nicht. Die Konfiguration liegt als Datei im Projektverzeichnis und lässt sich auch ohne Backend bearbeiten.

Für die Testphase vor der Umschaltung brauchst du meist eine vorläufige Adresse. Hinterlege sie als zusätzlichen Einstiegspunkt oder arbeite mit einem Eintrag in der lokalen Namensauflösung deines Rechners — dann sieht nur dein Rechner die neue Installation unter der echten Domain, während alle anderen weiterhin die alte sehen. Das ist der sauberste Weg zum Testen vor der Umstellung.

Testen vor der Umschaltung.

  • Startseite und mehrere Unterseiten, auch tief verschachtelte.
  • Backend-Anmeldung, Seitenbaum, ein Inhaltselement öffnen und speichern.
  • Bilder: im Frontend, im Backend und in der Dateiliste.
  • Formulare absenden — und prüfen, ob die Mail ankommt (E-Mails).
  • Suche, Downloads, geschützte Bereiche, falls vorhanden.
  • Mehrsprachigkeit: jede Sprache einmal aufrufen.
  • Protokolle ansehen auf neue Fehlermeldungen.

DNS umstellen.

Erst wenn die Tests durch sind, wird umgeschaltet. Setz die Gültigkeitsdauer der Einträge einige Stunden vorher herunter, damit die Umstellung schnell greift. Rechne trotzdem damit, dass für eine Weile beide Server erreichbar sind — in dieser Zeit sollten auf dem alten System keine Inhalte mehr gepflegt werden, sonst gehen sie verloren.

Setz dafür einen klaren Redaktionsstopp: ab einem genannten Zeitpunkt keine Änderungen mehr. Das ist organisatorisch wichtiger als jede technische Maßnahme — nachträglich zwei Datenstände zusammenzuführen ist deutlich aufwendiger als ein paar Stunden Pause.

Nicht vergessen: das Zertifikat für die neue Umgebung. Fehlt es nach der Umstellung, sehen Besucher eine Warnseite (Zertifikat).

Nach der Umschaltung.

  1. Alle Caches noch einmal leeren, auch vorgeschaltete Dienste.
  2. Zeitplan für Hintergrundvorgänge einrichten und prüfen, ob er läuft.
  3. Backups auf dem neuen Server einrichten und einmal testen.
  4. Protokolle über einige Tage beobachten.
  5. Den alten Server noch zwei bis vier Wochen stehen lassen, bevor er gekündigt wird.
  6. Suchmaschinen-Zugänge prüfen: Fehlerseiten und Indexierung beobachten.

Punkt fünf ist Versicherung: Solange der alte Server läuft, gibt es einen Rückweg und eine Quelle für vergessene Dateien.

Fallstricke.

  • Dateirechte: Per FTP hochgeladene Dateien gehören dem FTP-Benutzer, nicht dem Webserver — dann scheitert jede Bildverarbeitung.
  • Zeichensatz beim Datenbankexport nicht gesetzt.
  • Dateiindex nicht neu aufgebaut.
  • Mailversand nicht angepasst — die Zugangsdaten gelten für den alten Anbieter.
  • Geplante Vorgänge auf dem neuen Server nicht eingerichtet.
  • E-Mail-Postfächer vergessen, wenn sie beim alten Anbieter lagen.
  • Alten Server zu früh gekündigt.

Wenn du nicht weiterkommst.

Wenn ein Umzug ansteht oder nach einem Umzug Dinge fehlen, übernehme ich das mit Prüfliste und Rückweg. Schreib mir mit Domain, TYPO3-Version und einer kurzen Beschreibung — du bekommst eine ehrliche Einschätzung, ob ich der Richtige bin. Den Überblick über alle Themen gibt TYPO3-Fehler beheben. Wenn sich am Ende herausstellt, dass ein Wechsel die bessere Lösung ist: TYPO3 zu WordPress.

Fehleranalyse & Erste Hilfeab ~150 €

Ursache finden, Website wieder zum Laufen bringen, kurzer Bericht — meist am selben Tag.

Stundensatz~95 €

Für Anpassungen, Fehlerbehebung und Beratung nach Aufwand, abgerechnet in 15-Minuten-Schritten.

Wartungab ~49 €/Monat

Updates, Backups, Sicherheitscheck, Monitoring — Kleinigkeiten inklusive.

Orientierungswerte, keine Fixpreise — nach einem kurzen Gespräch bekommst du ein Festpreisangebot.

Wer hilft.

Ich bin Manuel Killert, Web-Entwickler aus Quakenbrück. Mein Schwerpunkt liegt auf WordPress — an TYPO3-Installationen arbeite ich dort, wo es um Betrieb und Fehlersuche geht: Ausfälle, Serverthemen, Datenbank, Mailversand, Updates und die Frage, wie es mit einer alten Installation weitergehen soll. Das sind die Probleme, bei denen die Ursache meist nicht im System selbst liegt, sondern darunter. Geht es um tiefe Entwicklung in TYPO3 — eigene Extensions, komplexe Mehrsprachigkeit, große Redaktionssysteme —, sage ich dir das offen und empfehle jemanden, der genau das macht. Ehrlich beraten heißt für mich auch, eine Anfrage abzugeben.

Häufige Fragen

FAQ — TYPO3 umziehen.

Was muss nach einem TYPO3-Umzug zwingend gemacht werden?

Fünf Schritte in dieser Reihenfolge: Konfiguration mit den neuen Datenbankzugängen anpassen, alle Caches leeren, Datenbankabgleich ausführen, Dateiindex neu aufbauen und die Site-Konfiguration auf die neue Domain prüfen.

Warum liefern nach dem Umzug alle Unterseiten 404?

Weil in der Site-Konfiguration noch die alte Domain steht oder die Serverregeln fehlen, die Adressen an TYPO3 weiterreichen. Die Startseite funktioniert dabei oft weiterhin.

Warum fehlen nach dem Umzug alle Bilder?

Meist weil der Dateiindex nicht neu aufgebaut wurde, das Bildbearbeitungsprogramm auf dem neuen Server fehlt oder die Dateirechte nicht stimmen.

Worauf muss ich beim Datenbankexport achten?

Auf den Zeichensatz. Export und Import müssen dieselbe Kodierung nutzen, sonst entsteht Zeichenmüll statt Umlauten — und das lässt sich nur durch erneuten Import beheben.

Wie teste ich vor der Umschaltung?

Über einen Eintrag in der lokalen Namensauflösung deines Rechners. Dann siehst nur du die neue Installation unter der echten Domain, während alle anderen weiterhin die alte sehen.

Wann kann ich den alten Server kündigen?

Zwei bis vier Wochen nach der Umstellung. Solange er läuft, gibt es einen Rückweg und eine Quelle für vergessene Dateien.

Manuel Killert (rechts im Bild) mit einem FreundDas bin ich – rechts im Bild
Kontakt

Erzähl mir, was an deinem TYPO3 klemmt.

Beschreib kurz das Problem und nenn mir die TYPO3-Version — du bekommst eine ehrliche Einschätzung, woran es liegt und was es kostet.

Antwort meist innerhalb von 24 Stunden · hallo@manuelkillert.de