Sichern Sie sich gratis Extraspeicher für Ihren neuen VPS! Mehr Platz. Mehr Potenzial.

Cloud VPS und Bare Metal Server zu unschlagbaren Preisen

So aktualisierst du deine selbstgehostete n8n-Instanz auf Contabo

/ / Tutorials
So aktualisierst du deine selbstgehostete n8n-Instanz auf Contabo (Titelbild)

Das Ausführen von n8n auf deinem eigenen Server gibt dir die volle Kontrolle über deine Workflow-Automatisierung. Aber nur wenn du es aktuell hältst, kannst du die neuen Funktionen und Sicherheitsupdates von n8n wirklich nutzen. Früher waren Updates oft mit komplexen, manuellen Schritten verbunden. Mit der Contabo-1-Klick-Installation in Docker dauert ein n8n-Update jetzt nur noch etwa fünf Minuten.

Dieser Guide führt dich durch jeden Schritt beim Aktualisieren deiner selbstgehosteten n8n-Instanz. Wir gehen durch, wie du dich mit deinem Server verbindest, deine Daten sicherst, die neueste Version herunterlädst und überprüfst, ob alles korrekt funktioniert. Der gesamte Prozess erfordert nur minimale technische Kenntnisse, die über das Grundlegende der SSH-Nutzung hinausgehen.

Bevor du beginnst: Was du benötigst

Du hast bereits Root-Zugriff auf deinen Contabo-Server, auf dem die 1-Klick-Installation von n8n läuft. Die Einrichtung verwendet Docker Compose mit Caddy als Reverse-Proxy und Let’s Encrypt für SSL-Zertifikate. Alle diese Komponenten befinden sich unter auf deinem Server.

Plane dieses Update während eines verkehrsarmeren Zeitraums. Deine n8n-Instanz wird 1-2 Minuten offline sein, während die Container neu starten. Alle derzeit ausgeführten Arbeitsabläufe werden gestoppt und müssen nach dem Update manuell wieder gestartet werden.

Verbinde dich mit deinem Server

Zuerst benötigst du die IP-Adresse deines Servers. Finde sie in deinem Customer Control Panel unter Meine Server > VPS oder VDS. Wähle deine Instanz aus – dort findest du die IP-Adresse in den Details.

Für Mac- und Linux-Benutzer

Öffne das Terminal und führe aus:

ssh root@your-ip-address

Ersetze mit deiner tatsächlichen IP-Adresse (Beispiel: 203.0.113.45).

Wenn du dazu aufgefordert wirst, gib dein Passwort ein (das Passwort, das du bei der Bestellung des Servers festgelegt hast).

Du kannst dich auch mit deinem Domainnamen anmelden. Fahre einfach mit der Maus über das n8n-Symbol für deine Instanz und kopiere die Informationen neben „Benutzername:“, dann führe einen SSH-Befehl wie den folgenden aus:

ssh [email protected]

Für Windows-Benutzer

Option 1: Mit PowerShell (Windows 10/11)

  1. Öffne PowerShell (suche im Startmenü nach „PowerShell“)
  2. Führe aus:
ssh root@your-ip-address
  1. Gib dein Passwort ein, wenn du dazu aufgefordert wirst

Option 2: Mit PuTTY

  1. Lade PuTTY von putty.org herunter und installiere es.
  2. Öffne PuTTY
  3. Gib im Feld „Host Name“ deine IP-Adresse ein
  4. Port: 22 (Standard)
  5. Verbindungstyp: SSH
  6. Klicke auf „Öffnen“
  7. Gib den Benutzernamen ein: oder (je nachdem, was du während der Konfiguration angegeben hast)
  8. Gib dein Passwort ein, wenn du dazu aufgefordert wirst

Sobald die Verbindung steht, siehst du eine Eingabeaufforderung wie diese:

root@vps-xxxxx:~#

Das bestätigt, dass du mit deinem Ubuntu-Server mit Root-Zugriff verbunden bist.

Die Contabo 1-Klick-Installation platziert alle n8n-Dateien in /opt/n8n/. Navigiere dorthin:

cd /opt/n8n

Deine Eingabeaufforderung ändert sich in:

root@vps-xxxxx:/opt/n8n#

Bevor du ein Update durchführst, solltest du deine n8n-Daten sichern. Du hast zwei Optionen.

Verwende das Auto Backup Add-On von Contabo

Wenn du das Auto Backup Add-On für dein VPS aktiviert hast, wird dein kompletter Server (einschließlich aller n8n-Workflows und Daten) bereits täglich gesichert. Keine zusätzliche Aktion erforderlich.

Manueller Workflow-Export

Wenn du keine automatischen Backups oder eine andere Backup-Lösung aktiviert hast, kannst du deine Workflows manuell über die n8n-Weboberfläche exportieren:

  1. Öffne deine n8n-Instanz im Browser
  2. Melde dich bei n8n an
  3. Klicke im Workflow-Editor auf die drei Punkte (⋯) in der oberen rechten Ecke
  4. Wähle Download
  5. Speichere die JSON-Datei auf deinem Computer
  6. Wiederhole das für jeden Workflow, den du sichern möchtest

So erhältst du ein Backup, das du bei Problemen während des Updates wiederherstellen kannst.

Lade das neueste n8n-Image herunter

Lade die neueste n8n-Version herunter. Führe aus:

docker compose pull

Damit holst du die aktuelle n8n-Version von Docker Hub. Deine laufende n8n-Instanz ist davon noch nicht betroffen – das bereitet nur die neue Version vor.

Währenddessen siehst du Ausgaben zum Download-Fortschritt:

[+] Pulling n8n
✔ latest Pulling from n8nio/n8n
✔ [layer info] Pull complete
...
Status: Downloaded newer image for n8nio/n8n:latest

Die Downloadzeit hängt von deiner Verbindungsgeschwindigkeit ab, dauert jedoch in der Regel 1-3 Minuten.

Stoppe die aktuellen Container

Stoppe nun die laufenden n8n-Container, bevor du sie mit der neuen Version startest.

Führe aus:

docker compose down

Dadurch werden die n8n- und Caddy-Container gestoppt und entfernt. Deine Workflows und Daten bleiben in den Docker-Volumes sicher.

Du wirst eine Ausgabe wie diese sehen:

[+] Running 2/2
✔ Container n8n     Removed
✔ Container caddy   Removed
✔ Network n8n_default  Removed

Deine n8n-Instanz ist während dieses Schritts vorübergehend offline. Alle aktuell laufenden Workflows werden beendet. Deshalb solltest du das Update in einem Wartungsfenster einplanen, wenn bei dir dauerhaft Workflows laufen.

Starte die aktualisierten Container

Starte nun n8n mit der neuesten Version, die du gerade heruntergeladen hast.

Führe aus:

docker compose up -d

Dadurch werden die n8n- und Caddy-Container mit dem neuesten Image gestartet. Die Option startet sie im Hintergrundmodus (detached mode), sodass sie weiterlaufen, auch wenn du die SSH-Verbindung schließt.

Du wirst sehen:

[+] Running 2/2
✔ Container caddy   Started
✔ Container n8n     Started

n8n benötigt etwa 30-60 Sekunden, um vollständig zu initialisieren und über deinen Browser zugänglich zu werden.

Verifiziere das Update

Überprüfe, ob das Update erfolgreich war und n8n ordnungsgemäß läuft.

Überprüfe zuerst, ob die Container laufen:

docker ps

Du solltest sowohl die als auch die -Container mit dem Status „Läuft“ aufgelistet sehen:

CONTAINER ID   IMAGE           STATUS         PORTS
abc123def456   n8nio/n8n       Up 2 minutes   0.0.0.0:5678->5678/tcp
def789ghi012   caddy           Up 2 minutes   0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp

Überprüfe als nächstes, ob n8n zugänglich ist:

  1. Öffne deine n8n-URL in einem Webbrowser (die gleiche URL, die du normalerweise verwendest)
  2. Melde dich bei deiner n8n-Instanz an
  3. Klicke auf dein Benutzersymbol (unten links)
  4. Klicke auf Settings
  5. Überprüfe die in der unteren linken Ecke angezeigte Versionsnummer

Die Versionsnummer sollte neuer sein als die, die du vor dem Update hattest. Deine Workflows und Anmeldeinformationen sollten vollständig intakt sein und normal funktionieren.

Alte Images bereinigen (optional)

Nach dem Update bleiben alte Docker-Images auf deinem Server und belegen Speicherplatz. Entferne sie, um Speicherplatz freizugeben.

Führe aus:

docker image prune -a

Du wirst eine Warnung sehen:

WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N]

Gib y ein und drücke die Eingabetaste, um zu bestätigen.

Dies entfernt ungenutzte Docker-Images, einschließlich der alten n8n-Version, die du gerade ersetzt hast. Es kann mehrere hundert MB Speicherplatz freigeben.

Du wirst sehen:

Deleted Images:
untagged: n8nio/n8n@sha256:abc123...
deleted: sha256:def456...
...
Total reclaimed space: 450MB

Dies entfernt nur ungenutzte Images. Deine laufenden n8n-Container und alle Daten bleiben unberührt.

Wann man aktualisieren sollte

n8n veröffentlicht regelmäßig Updates. Hauptversionen bringen neue Funktionen und Knoten. Nebenversionen beheben Fehler und schließen Sicherheitslücken. Du musst nicht sofort aktualisieren, wenn eine neue Version veröffentlicht wird, aber es macht Sinn, dies monatlich zu überprüfen.

Sicherheits-Patches erfordern schnellere Updates. Wenn n8n eine Sicherheitsanfälligkeit bekannt gibt, plane ein Update innerhalb weniger Tage. Der Update-Prozess, den wir gerade durchgegangen sind, funktioniert gleich, unabhängig davon, ob du mehrere Versionen überspringst oder auf die gestern veröffentlichte Version aktualisierst.

Häufige Probleme beheben

Die meisten Updates werden ohne Probleme abgeschlossen. Manchmal geht etwas schief.

Wenn n8n nach dem Update nicht startet, überprüfe zuerst die Docker-Container, um zu sehen, ob sie alle laufen oder ob es Probleme gibt, indem du den folgenden Befehl nutzt:

docker compose ps

Wenn dies keine Probleme offenbart, überprüfe die Container-Protokolle:

docker compose logs n8n

Achte auf Fehlermeldungen am Ende der Ausgabe. Häufige Probleme sind Datenbankmigrationen oder Konfigurationskonflikte.

Wenn Arbeitsabläufe nach dem Update nicht ausgeführt werden, überprüfe, ob die Datenbankverbindungen noch funktionieren. Manchmal ändern sich die Anmeldeformate zwischen Hauptversionen. Teste zuerst einen einfachen Workflow, bevor du annimmst, dass alles kaputt ist.

Wenn die Weboberfläche nicht lädt, überprüfe, ob Caddy läuft und die Zertifikate gültig sind:

docker compose logs caddy

Probleme mit der Erneuerung von Zertifikaten treten gelegentlich auf. Ein Neustart von Caddy behebt das in der Regel:

docker compose restart caddy

Updates automatisieren mit Watchtower (Optional)

Wenn du möchtest, dass n8n automatisch ohne manuelle Eingriffe aktualisiert wird, kann Watchtower das übernehmen. Es ist ein Docker-Container, der deine anderen Container überwacht und sie aktualisiert, wenn neue Images verfügbar sind.

Watchtower prüft regelmäßig auf Updates, lädt das neueste Image herunter, stoppt deinen aktuellen Container und startet die neue Version. Alles automatisch.

Um Watchtower zu deiner n8n-Konfiguration hinzuzufügen, musst du die Datei docker-compose.yml unter /opt/n8n/ bearbeiten:

nano /opt/n8n/docker-compose.yml

Füge diesen Watchtower-Dienst zu deiner bestehenden docker-compose.yml hinzu:

watchtower:
    image: containrrr/watchtower
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --cleanup --interval 86400

Die --interval 86400  Flag weist Watchtower an, alle 24 Stunden nach Updates zu suchen. Das Kennzeichen entfernt alte Images nach dem Update.

Speichere die Datei und starte deine Dienste neu:

docker compose up -d

Watchtower läuft jetzt neben n8n und prüft täglich auf Updates.

Wichtige Überlegungen: Automatische Updates bedeuten, dass du die Versionshinweise vor dem Update nicht überprüfst. Änderungen oder neue Fehler könnten deine Workflows unbemerkt beeinflussen. Für Produktionsumgebungen geben dir manuelle Updates mehr Kontrolle. Für Entwicklungs- oder persönliche Instanzen, bei denen Aktualität wichtiger ist als Stabilität, funktioniert Watchtower gut.

Du kannst Watchtower auch im Überwachungsmodus mit E-Mail-Benachrichtigungen ausführen, sodass du über verfügbare Updates informiert wirst, ohne sie automatisch anzuwenden. Überprüfe die Watchtower-Dokumentation auf Konfigurationsoptionen, die zu deinen Bedürfnissen passen.

Warum regelmäßig aktualisieren

n8n-Versionen enthalten Leistungsverbesserungen, Fehlerbehebungen und Sicherheitsupdates. Neue Knoten für Dienste erscheinen ebenfalls in Updates. Innerhalb weniger Versionen der neuesten Version zu bleiben, erleichtert die Fehlersuche, wenn du Hilfe von der Community benötigst.

Überprüfe monatlich auf Updates. Sicherheitsupdates erfordern schnelles Handeln – aktualisiere innerhalb weniger Tage, wenn Schwachstellen bekannt gegeben werden.

Deine Workflows bleiben während der Updates sicher. Alle Daten leben in Docker-Volumes, die über Containerneustarts hinaus bestehen bleiben. Die neue Version setzt genau dort an, wo die alte aufgehört hat. All dies bedeutet, dass du (und sollst) deine n8n-Instanz regelmäßig aktualisieren kannst, indem du diese einfache Anleitung befolgst.

Denke daran, wenn du Probleme auf Serverebene hast, sind wir immer hier, um zu helfen. Beginne mit der Contabo-Dokumentation. Bei n8n-spezifischen Problemen findest du viele Antworten in der n8n-Dokumentation und den aktiven Community Foren.

Nach oben scrollen