ioBroker Backup wiederherstellen und auf neue Hardware umziehen

Der Server ist tot, die SD-Karte hin, oder das Update hat das System zerlegt. Wenn du gerade in dieser Lage bist, hier zuerst der kurze Weg. Die Erklärungen kommen danach.

Der schnelle Weg

Vorausgesetzt, ioBroker ist auf dem Zielsystem frisch installiert und die Backup-Datei liegt in /opt/iobroker/backups:

cd /opt/iobroker
iobroker stop
iobroker restore
iobroker restore 0
iobroker upload all
iobroker start

Der dritte Befehl ohne Zahl zeigt die vorhandenen Sicherungen mit einer Nummer an. Die 0 ist immer die neueste. Der vierte Befehl spielt genau diese ein.

Danach kann es eine gute Stunde dauern, bis alles läuft. Das ist normal, und warum, steht weiter unten.

Schritt für Schritt

1. Die Sicherung an die richtige Stelle legen

ioBroker sucht seine Sicherungen ausschließlich in einem festen Ordner:

ls -l /opt/iobroker/backups/

Liegt die Datei auf einem NAS oder einem USB-Stick, gehört sie zuerst dorthin kopiert. Die Dateinamen sehen aus wie 2026_09_13-03_00_12_backupiobroker.tar.gz.

Wichtig sind dabei die Rechte. Die Datei muss dem Benutzer gehören, unter dem ioBroker läuft. Wer sie als root kopiert hat, korrigiert das mit:

sudo chown iobroker:iobroker /opt/iobroker/backups/*.tar.gz

2. Die Liste anzeigen

Der Befehl iobroker restore ohne weitere Angabe gibt aus, was zur Auswahl steht. Jede Zeile enthält den Dateinamen, das Datum und eine laufende Nummer.

Die Nummerierung beginnt bei der neuesten Sicherung mit 0 und zählt in die Vergangenheit hoch. Wer die zweitneueste einspielen will, nimmt die 1.

Ein Hinweis dazu, weil er in vielen Anleitungen falsch steht: Einen Befehl iobroker list backups gibt es nicht. Der Unterbefehl list kennt nur Objekte, Zustände, Instanzen, Adapter und ähnliche Typen. Für Sicherungen ist allein iobroker restore zuständig.

3. ioBroker anhalten

iobroker stop

Das ist keine Empfehlung, sondern Bedingung. Ein laufender ioBroker schreibt währenddessen in dieselben Datenbanken, die gerade überschrieben werden. Das Ergebnis ist ein halb wiederhergestellter Zustand, der schwerer zu reparieren ist als der Ausgangsschaden.

4. Wiederherstellen

iobroker restore 0

Statt der Nummer geht auch der Zeitstempel oder der vollständige Dateiname. Diese vier Varianten führen zum selben Ergebnis:

iobroker restore 0
iobroker restore 2026_09_13-03_00_12
iobroker restore 2026_09_13-03_00_12_backupiobroker.tar.gz
iobroker restore /opt/iobroker/backups/2026_09_13-03_00_12_backupiobroker.tar.gz

Wiederhergestellt werden dabei alle Objekte, alle Zustände und die Benutzerdateien, also auch die VIS-Oberflächen.

5. Dateien hochladen und starten

iobroker upload all
iobroker start

Jetzt beginnt der Teil, bei dem die meisten die Nerven verlieren. Der js-controller stellt fest, welche Adapter in der Konfiguration stehen und auf dem System fehlen, und installiert sie im Hintergrund nach. Bei einem gewachsenen Aufbau mit vierzig Adaptern dauert das auf einem Raspberry Pi leicht eine Stunde.

In dieser Zeit sieht die Oberfläche kaputt aus. Adapter stehen auf rot, Instanzen fehlen, Werte kommen nicht. Das ist kein Fehler. Den Fortschritt sieht man im Log:

iobroker logs --lines 50

Umzug auf neue Hardware

Der Wechsel vom Raspberry Pi auf einen Mini-PC oder in eine virtuelle Maschine unter Proxmox läuft über denselben Weg. Vier Punkte entscheiden darüber, ob es glattgeht.

Gleiche oder neuere Versionen

Auf dem Zielsystem muss die ioBroker-Version mindestens so aktuell sein wie auf dem Quellsystem. Ein Backup aus js-controller 7 lässt sich nicht sauber in eine Installation mit js-controller 5 einspielen.

Die andere Richtung ist unkritisch. Ein älteres Backup auf einer neueren Installation funktioniert.

Die Node-Version zuerst

Auf dem neuen System gehört vor dem Restore die richtige Node-Version installiert. Seit Node.js 20 keine Sicherheitsupdates mehr bekommt, ist das die 22er-Reihe. Wie das geht, steht im Beitrag zu ioBroker auf Node.js 22 aktualisieren.

Wer das hinterher nachholt, muss anschließend alle Adapter mit nativen Anteilen erneut übersetzen lassen. Vorher ist einfacher.

Der Architekturwechsel

Ein Raspberry Pi rechnet mit ARM, ein NUC oder eine Proxmox-VM mit x86. Adapter, die kompilierte Bestandteile mitbringen, laufen deshalb nicht einfach weiter.

Der Restore selbst kümmert sich nicht darum, weil er nur Konfiguration einspielt. Die Adapter werden aber ohnehin auf dem neuen System frisch installiert, und damit stimmt die Architektur wieder. Genau deshalb dauert der Vorgang so lange.

Bleiben einzelne Adapter danach hängen, hilft ein gezieltes Neuübersetzen:

iobroker rebuild

Wie der Aufbau mit Proxmox auf einem Intel NUC aussieht, steht im Beitrag zu Intel NUC, Proxmox und ioBroker.

Die Hardware am neuen Rechner

Der Punkt, der am häufigsten übersehen wird. Ein Zigbee-Stick, der am Pi unter /dev/ttyACM0 lief, hat am neuen Rechner möglicherweise einen anderen Pfad. Dasselbe gilt für Z-Wave-Sticks und serielle Adapter.

Nach dem Restore steht in der Adapterkonfiguration der alte Pfad. Der Adapter startet, findet nichts und geht wieder aus. Prüfen lässt sich das so:

ls -l /dev/serial/by-id/

Diesen Pfad mit der Seriennummer trägt man in den Adapter ein, nicht die durchnummerierte Variante. Er bleibt auch nach einem Neustart gleich.

Was im Backup nicht drin ist

Das ist der Abschnitt, den man vor dem Ernstfall lesen sollte. Ein ioBroker-Backup ist eine Sicherung der Konfiguration, keine Sicherung des ganzen Systems.

• Verlaufsdaten aus InfluxDB. Das Standard-Backup sichert die Adaptereinstellungen, nicht den Inhalt der Zeitreihendatenbank. Wer seine Messwerte über Jahre behalten will, braucht dafür eine eigene Sicherung. Backitup kann das zusätzlich übernehmen, es muss aber eingeschaltet werden.
• Zugangsschlüssel für InfluxDB und Grafana. Die Token werden bei einer Wiederherstellung nicht mit eingespielt. Man legt sie neu an und trägt sie in den Adapter ein.
• Dateien des History-Adapters. Wer den einfachen History-Adapter nutzt, der seine Daten in Dateien ablegt, sollte diesen Ordner gesondert sichern.
• Zertifikate aus dem System. Eigene Zertifikate, die außerhalb von ioBroker liegen, etwa für einen Reverse Proxy, gehören nicht dazu.
• Die Zigbee-Kopplungen im Stick. Das Zigbee-Netz steckt im Koordinator, nicht in ioBroker. Wer den Stick mitnimmt, nimmt das Netz mit. Wer einen neuen Stick verwendet, lernt alles neu an.

Für ein Backup, das wirklich alles umfasst, sichert man die ganze virtuelle Maschine. Wie das mit Proxmox und einem NAS läuft, steht im Beitrag zu Proxmox Backup auf Synology NAS.

Adapter starten nach dem Restore nicht

Vorweg der wichtigste Rat: Erst eine Stunde warten und ins Log schauen. Die meisten vermeintlichen Fehler sind Adapter, die noch gar nicht fertig installiert sind.

Bleibt danach etwas rot, sind es fast immer diese drei Ursachen.

Ursache 1: Die Node-Version passt nicht

Im Log stehen dann Meldungen über nicht unterstützte Sprachmerkmale oder Module, die sich nicht laden lassen.

node -v
iobroker -v

Steht dort eine 18 oder eine 20, gehört Node aktualisiert. Steht dort eine 24, kann es die andere Richtung sein, denn nicht jeder Adapter kommt damit zurecht.

Ursache 2: Rechte und Eigentümer stimmen nicht

Wer einzelne Schritte als root ausgeführt hat, hinterlässt Dateien, die dem ioBroker-Benutzer nicht gehören. Dafür gibt es ein eigenes Werkzeug:

iobroker fix

Das räumt Rechte und Sicherheitseinstellungen wieder ein. Danach ioBroker neu starten.

Ursache 3: Pfade, Adressen und Ports

Die Konfiguration kommt vom alten System und beschreibt dessen Umgebung. Drei Dinge wandern dabei regelmäßig:

• Gerätepfade für Funksticks, siehe oben
• Die IP-Adresse des Rechners, wenn Adapter sich darauf beziehen oder ein Gerät den alten Server anspricht
• Belegte Ports, wenn auf dem neuen System schon etwas anderes läuft, häufig beim Web-Adapter auf Port 8082

Im Log steht in diesen Fällen meistens eine deutliche Meldung, etwa dass eine Adresse bereits in Benutzung ist. Das Log lohnt den Blick vor jeder Vermutung.

Damit es beim nächsten Mal automatisch läuft

Wer diesen Artikel im Ernstfall gefunden hat, sollte den nächsten Ernstfall vorbereiten. Dafür gibt es den Adapter Backitup.

Die Einstellungen, auf die es ankommt:

1. Ein Zeitplan, der wirklich läuft. Täglich nachts ist eine vernünftige Vorgabe. Wichtig ist, danach einmal nachzusehen, ob tatsächlich eine Datei entstanden ist.
2. Ein Ziel außerhalb des Rechners. Eine Sicherung auf derselben SD-Karte ist wertlos, wenn genau diese Karte stirbt. Backitup kann auf ein NAS über CIFS oder NFS schreiben, auf einen FTP-Server oder in einen Cloudspeicher.
3. Die Anzahl der aufbewahrten Sicherungen. Mindestens sieben, damit ein Fehler, der erst nach Tagen auffällt, noch zurückgeholt werden kann.
4. Die Zusatzsicherungen einschalten. InfluxDB, Redis, der Javascript-Adapter und Zigbee haben eigene Schalter. Wer sie nicht setzt, sichert sie nicht.
5. Eine Benachrichtigung einrichten. Telegram oder E-Mail bei Fehlschlag. Eine Sicherung, die seit Monaten nicht mehr läuft und von der niemand weiß, ist der häufigste Grund für einen Totalverlust.

Wie die Ablage auf einem NAS eingerichtet wird, steht im Beitrag zu ioBroker Backup auf Synology NAS.

Und der Rat, der am meisten wert ist: Einmal im Jahr eine Wiederherstellung üben, am besten in einer zweiten virtuellen Maschine. Eine Sicherung, die noch nie zurückgespielt wurde, ist eine Vermutung.

Die Kurzfassung

1. Backup nach /opt/iobroker/backups kopieren, Rechte prüfen.
2. Node-Version auf dem Zielsystem stimmt, ioBroker ist mindestens so aktuell wie das Backup.
3. iobroker stop
4. iobroker restore für die Liste, dann iobroker restore 0
5. iobroker upload all und iobroker start
6. Eine Stunde warten und ins Log schauen.
7. Gerätepfade der Funksticks anpassen.
8. Bei Rechteproblemen iobroker fix.

Fazit

Die Wiederherstellung selbst besteht aus vier Befehlen und ist in wenigen Minuten angestoßen. Die Zeit danach kostet Geduld, weil sämtliche Adapter neu installiert werden.

Die Fallstricke liegen nicht im Restore, sondern drumherum. Eine unpassende Node-Version, ein Gerätepfad, der sich verschoben hat, und Verlaufsdaten, die im Backup nie enthalten waren. Wer diese drei Punkte kennt, kommt ohne Überraschungen durch.

Transparenzhinweis: Die Amazon-Links in diesem Artikel sind Partnerlinks. Wenn Sie darüber bestellen, erhalten wir eine kleine Provision. Für Sie ändert sich am Preis nichts.