IOBroker Update – Alle Befehle erklärt

IOBroker ist eine der beliebtesten Smart-Home-Plattformen für Linux-Systeme (z. B. Raspberry Pi). Damit die Installation aktuell und sicher bleibt, braucht es regelmässige Updates. Hier sind alle wichtigen Befehle erklärt.


Vorbereitung: Systempakete aktuell halten

sudo apt update && sudo apt upgrade

Aktualisiert zunächst die Paketliste des Systems (apt update) und installiert dann alle verfügbaren Updates für die installierten Systempakete (apt upgrade). sudo ist notwendig, weil Root-Rechte gebraucht werden. Das && sorgt dafür, dass der zweite Befehl nur ausgeführt wird, wenn der erste erfolgreich war.

Wann: Vor jedem IOBroker-Update – damit das System-Basis auf dem neuesten Stand ist.


1. IOBroker stoppen

iob stop

Stoppt alle laufenden IOBroker-Adapter und den IOBroker-Kern. Wichtig: Das Update sollte immer im gestoppten Zustand laufen, damit keine Konflikte entstehen während Dateien ausgetauscht werden.

Tipp: Mit iob status kann man anschliessend prüfen, ob alles wirklich gestoppt ist.


2. IOBroker-Updater aktualisieren

iob update

Holt die aktuellste Version des IOBroker-Update-Scripts vom Repository. Damit wird sichergestellt, dass die Update-Logik auf dem neuesten Stand ist, bevor die eigentlichen Adapter aktualisiert werden.

Wann: Mindestens einmal pro Monat oder wenn ein grosses Versions-Update ansteht.


3. Adapter aktualisieren

iob upgrade --yes

Aktualisiert alle installierten IOBroker-Adapter auf die neuesten verfügbaren Versionen. Das Flag --yes (Kurzform: -y) bestätigt alle Rückfragen automatisch und macht das Update non-interaktiv – ideal für Skripte und Cronjobs.

Was wird aktualisiert: Alle npm-Pakete, die IOBroker-Instanzen, die Adapter-Definitions.

Wann: Regelmässig – mindestens alle 2–4 Wochen.


4. IOBroker selbst aktualisieren

iob upgrade self --yes

Aktualisiert die IOBroker-Kernplattform selbst (den sogenannten Controller). Das ist das Herzstück von IOBroker – die zentrale Software, die alle Adapter verwaltet. Das --yes bestätigt automatisch.

Wann: Wenn eine neue IOBroker-Hauptversion verfügbar ist (z. B. Update von 5.x auf 6.x) oder wenn der Kernel aktualisiert werden muss.


5. Fehlerbehebung

iob fix

Ein vielseitiger Reparatur-Befehl. Er prüft und behebt typische Probleme nach einem Update:

  • Fehlende oder defekte npm-Abhängigkeiten werden neu installiert
  • Berechtigungsprobleme (Permissions) werden korrigiert
  • Adapter-Installationen, die im Fehlerzustand hängen, werden bereinigt
  • Die Node.js-Host-Instanz wird repariert, falls sie defekt ist

Wann: Immer dann, wenn nach einem Update Fehlermeldungen auftauchen oder Adapter nicht starten. Auch empfohlen nach unerwarteten Abstürzen.


Die komplette Update-Sequenz

Die empfohlene Reihenfolge für ein vollständiges System-Update:

  1. sudo apt update && sudo apt upgrade – Systempakete aktuell halten
  2. iob stop – IOBroker stoppen
  3. iob update – Update-Script aktualisieren
  4. iob upgrade --yes – Alle Adapter aktualisieren
  5. iob upgrade self --yes – IOBroker-Kern aktualisieren (bei Hauptversion)
  6. iob fix – Fehlerbehebung und Aufräumen

Hinweise

  • IOBroker sollte nicht im laufenden Betrieb aktualisiert werden – immer zuerst iob stop.
  • Nach einem iob upgrade self empfiehlt sich ein anschliessendes iob start, um den Controller neu zu starten.
  • Bei Problemen nach dem Update: iob fix ausführen – das löst die häufigsten Fehler.
  • Regelmässige Updates sind wichtig für die Sicherheit (IOBroker hat eine Weboberfläche, die oft aus dem Netz erreichbar ist).