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:
sudo apt update && sudo apt upgrade– Systempakete aktuell halteniob stop– IOBroker stoppeniob update– Update-Script aktualisiereniob upgrade --yes– Alle Adapter aktualisiereniob upgrade self --yes– IOBroker-Kern aktualisieren (bei Hauptversion)iob fix– Fehlerbehebung und Aufräumen
Hinweise
- IOBroker sollte nicht im laufenden Betrieb aktualisiert werden – immer zuerst
iob stop. - Nach einem
iob upgrade selfempfiehlt sich ein anschliessendesiob start, um den Controller neu zu starten. - Bei Problemen nach dem Update:
iob fixausfü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).