Serverwechsel ohne Ausfall

Ein Serverwechsel für selbst gehostetes n8n gelingt ohne spürbaren Ausfall, wenn Sie nach dem Blue-Green-Prinzip vorgehen: Der neue Server wird komplett parallel zum alten aufgebaut und mit den migrierten Daten getestet, bevor die DNS-Umstellung den Traffic umlenkt. Entscheidend ist dabei, dass Workflows, Credentials und die n8n-Datenbank vollständig und mit dem gleichen Verschlüsselungsschlüssel auf den neuen Server übertragen werden, denn n8n nutzt den N8N_ENCRYPTION_KEY zur Entschlüsselung gespeicherter Zugangsdaten. Wer diesen Schlüssel beim Umzug vergisst, verliert den Zugriff auf alle hinterlegten Credentials, auch wenn die Workflows selbst importiert werden konnten. Stand: Juli 2026.

Neuen Server vorbereiten

Bevor Sie irgendetwas migrieren, sollte der neue Server (zum Beispiel eine frische Hetzner-Cloud-Instanz) lauffähig eingerichtet sein, inklusive Docker beziehungsweise Docker Compose, Reverse Proxy und Firewall-Regeln für die Ports 80 und 443. Für Hetzner-Setups beschreibt die n8n-Dokumentation zum Hosting auf Hetzner den Aufbau mit Docker Compose und Caddy als Reverse Proxy, samt persistenten Volumes für die n8n-Daten.

• Docker-Umgebung: n8n und der Reverse Proxy laufen als Container mit eigenen Volumes, damit Daten Neustarts überstehen.
• Subdomain für den Test: Legen Sie zunächst einen zweiten DNS-Eintrag an (etwa n8n-neu.ihredomain.de), damit Sie den neuen Server testen können, bevor die Hauptdomain umgestellt wird.
• Gleiche n8n-Version: Prüfen Sie, dass die n8n-Version auf dem neuen Server zur Version auf dem alten Server passt oder bewusst aktualisiert wird, um Importfehler zu vermeiden.

Workflows, Credentials und Datenbank migrieren

n8n bietet über die CLI-Befehle für Export und Import dedizierte Kommandos, die Workflows und Credentials jeweils getrennt behandeln. Ein vollständiges Backup lässt sich mit den Flags --backup und --output erzeugen, ein Import mit --input und --separate zurückspielen.

• Workflows exportieren: n8n export:workflow --backup --output=backups/latest/ sichert alle Workflows formatiert und als Einzeldateien.
• Credentials exportieren: n8n export:credentials --backup --output=backups/latest/ sichert die Zugangsdaten weiterhin verschlüsselt; die Option --decrypted zeigt sie im Klartext und sollte nur für kontrollierte Migrationen genutzt werden.
• Auf dem neuen Server importieren: n8n import:workflow --separate --input=backups/latest/ und n8n import:credentials --separate --input=backups/latest/ spielen die Dateien zurück.
• Verschlüsselungsschlüssel übernehmen: Setzen Sie N8N_ENCRYPTION_KEY auf dem neuen Server exakt auf den Wert des alten Servers, sonst lassen sich importierte Credentials nicht entschlüsseln.
• Datenbankordner beachten: Der Ordner hinter N8N_USER_FOLDER enthält neben der SQLite-Datenbank auch weitere lokale Konfigurationsdaten und gehört ebenfalls ins Backup, sofern Sie nicht ohnehin auf eine externe PostgreSQL-Datenbank umsteigen.

Laut n8n-Dokumentation exportieren diese Befehle auch die internen IDs von Workflows und Credentials mit. Bestehen auf dem Zielserver bereits Datensätze mit denselben IDs, werden sie beim Import überschrieben, ein wichtiger Punkt, wenn der neue Server nicht komplett leer aufgesetzt wird. Importierte Workflows sind zudem standardmäßig deaktiviert und müssen nach der Prüfung bewusst wieder aktiviert werden.

Nach dem Import: Testen Sie kritische Workflows manuell über die Test-Subdomain, prüfen Sie Trigger, Webhooks und Verbindungen zu externen Diensten, und vergleichen Sie stichprobenartig die Anzahl der Workflows und Credentials zwischen altem und neuem Server.

DNS umstellen: Blue-Green ohne Ausfall

Erst wenn der neue Server unter der Test-Subdomain zuverlässig läuft, wird die eigentliche Domain umgestellt. Senken Sie vorab die TTL des betroffenen DNS-Eintrags auf einen niedrigen Wert (zum Beispiel 300 Sekunden), damit die Umstellung schnell greift. Ändern Sie dann den A-Eintrag der Hauptdomain auf die IP-Adresse des neuen Servers. Während der Übergangszeit laufen alte und neue Instanz parallel, sodass eingehende Requests je nach DNS-Cache-Stand kurzzeitig auf beide Server verteilt werden können. Bei webhook-gesteuerten Workflows kann dies dazu führen, dass einzelne Aufrufe während des Umschaltfensters den alten statt den neuen Server erreichen, weshalb Webhook-intensive Workflows in dieser Phase besonders beobachtet werden sollten.

Alten Server abschalten

Warten Sie nach der DNS-Umstellung mindestens die alte TTL-Zeit plus einen Sicherheitspuffer ab, bevor Sie den alten Server abschalten. Prüfen Sie in dieser Zeit die Logs des neuen Servers auf eingehenden Traffic und stellen Sie sicher, dass keine wichtigen Executions mehr auf dem alten System laufen. Erst wenn der neue Server über einen längeren Zeitraum stabil den gesamten Traffic verarbeitet, sollten Sie den alten Server stoppen und ein letztes Backup archivieren, bevor er endgültig gelöscht wird. NordFlux setzt dieses Vorgehen bei Serverwechseln für Kunden mit selbst gehostetem n8n standardmäßig ein, um die deutsche Datenhoheit und die Kontrolle über die Infrastruktur durchgehend zu erhalten.

Häufige Fragen zu Serverwechsel ohne Ausfall

Wie lange dauert ein Blue-Green-Serverwechsel bei n8n?

Das hängt von der Anzahl der Workflows, der Datenmenge und der TTL der DNS-Einträge ab. Die eigentliche Migration der Daten ist meist in wenigen Minuten erledigt, die DNS-Umstellung mit Sicherheitspuffer kann je nach TTL-Konfiguration einige Stunden dauern.

Was passiert, wenn der Verschlüsselungsschlüssel nicht übertragen wird?

Ohne den identischen N8N_ENCRYPTION_KEY lassen sich importierte Credentials nicht entschlüsseln. Workflows erscheinen zwar, aber Verbindungen zu externen Diensten schlagen fehl, bis die Zugangsdaten neu hinterlegt werden.

Reicht ein einfacher Datenbank-Export für die Migration?

Für eine vollständige Migration sollten Sie sowohl die Workflows als auch die Credentials über die dedizierten n8n-CLI-Befehle exportieren, zusätzlich zum eigentlichen Datenbankordner beziehungsweise einer externen PostgreSQL-Instanz, falls diese im Einsatz ist.

Muss n8n während der Migration abgeschaltet werden?

Nein. Der alte Server bleibt beim Blue-Green-Vorgehen bis zur erfolgreichen DNS-Umstellung aktiv und nutzbar. Die eigentliche Downtime beschränkt sich im Idealfall auf den kurzen DNS-Umschaltmoment.