ioBroker Admin 8 Update

Admin 8 ist im Stable-Repository angekommen und damit für alle sichtbar, die keine Beta-Quellen eingestellt haben. Das Update ist allerdings keines, das man nebenbei durchwinkt. Es setzt Node.js 22 voraus und verlangt, dass 22 Adapter gleichzeitig mitgezogen werden.

Die harte Voraussetzung zuerst

Admin 8 läuft nur ab Node.js 22. Wer noch auf Version 20 unterwegs ist, muss dort zuerst aktualisieren. Das lässt sich schnell prüfen:

node -v

Steht dort eine 20 am Anfang, ist der Weg über iob nodejs-update 22 der erste Schritt. Erst danach macht das Admin-Update Sinn. Node.js 20 ist seit dem 30. April 2026 ohnehin ohne Sicherheitsunterstützung, insofern steht diese Arbeit unabhängig von Admin 8 an.

Die 22 Adapter, die mitmüssen

Das ist der Punkt, an dem die meisten Update-Probleme entstehen. Admin 8 hat die Grundlage für Konfigurationsseiten umgestellt. Adapter, die noch auf dem alten Stand sind, zeigen anschließend keine funktionierende Einstellungsseite mehr.

Betroffen sind diese Adapter mit ihren Mindestversionen:

• acme ab 4.0.3
• alarm ab 5.0.1
• backitup ab 4.0.3
• email ab 3.0.0
• govee-smart ab 2.27.0
• hmip ab 3.1.1
• icloud ab 2.0.0
• javascript ab 10.1.3
• kisshome-defender ab 3.0.1
• klf200 ab 1.4.0
• mytime ab 3.0.1
• nmea ab 2.0.0
• nspanel-lovelace-ui ab 1.0.0
• parser ab 4.0.1
• ping ab 3.0.1
• plex ab 3.0.0
• public-holidays ab 0.13.2
• public-transport ab 1.2.0
• pushbullet ab 3.0.1
• solectrus-influxdb ab 2.0.1
• telegram ab 5.0.3
• welcome ab 2.0.1

Die passenden Versionen sind zusammen mit Admin 8 ins Stable-Repository gewandert, ein normales Adapter-Update holt sie also ab. Eine Ausnahme ist icloud, das laut Ankündigung nicht im Stable liegt. Wer den Adapter betreibt, muss die Version von Hand nachziehen.

Wer keinen dieser Adapter installiert hat, kann diesen Abschnitt überspringen. Bei javascript, backitup und telegram dürfte das allerdings kaum jemand von sich sagen.

Was Admin 8 mitbringt

Der größte Teil der Arbeit steckt unter der Oberfläche. Die gesamte Benutzeroberfläche wurde auf React 19 und MUI 9 gehoben. Das erklärt auch, warum die Adapter nachziehen müssen, denn ihre Konfigurationsseiten laufen im selben Rahmen.

Sichtbar ist der überarbeitete Einrichtungsassistent für den ersten Start, der jetzt auch einen Schritt zurück erlaubt. Nach der Installation eines Adapters aus npm, GitHub oder einer Datei lässt sich direkt eine Instanz anlegen, was einen Klickweg spart.

Zwei Änderungen sind für bestimmte Aufbauten wichtig. Der Betrieb hinter einem Reverse Proxy funktioniert nun auch in einem Unterpfad wie /admin/. Und ein Sicherheitsfehler bei der Anmeldung über OAuth2 wurde behoben, wobei zusätzlich die CORS-Kopfzeilen berichtigt wurden, die den Abruf des Tokens aus anderen Herkünften blockierten.

Dazu kommen kleinere Verbesserungen. Der Suchdialog öffnet sich auf den Ergebnissen, wenn aus einem früheren Durchlauf noch offene Vorschläge liegen. Anfragen an einen Host, der gar nicht läuft, werden sofort mit einem Zeitfehler beantwortet, statt die Oberfläche warten zu lassen. Die Reihe steht inzwischen bei 8.0.11, es wird also weiter nachgebessert.

Die Reihenfolge beim Update

Erst sichern, dann Node prüfen, dann aktualisieren.

iob backup
node -v
iob update

Danach in der Oberfläche unter Adapter alle verfügbaren Updates einspielen. Wer lieber auf der Kommandozeile arbeitet:

iob upgrade all

Der Admin-Adapter aktualisiert sich dabei selbst und startet neu. Für einen Moment ist die Oberfläche weg, das ist normal.

Wenn die Oberfläche weiß bleibt

Der häufigste Fall nach einem Admin-Update ist ein Browser, der noch die alten Dateien im Zwischenspeicher hat. Ein harter Neuladevorgang mit Strg und F5 löst das in den meisten Fällen. Hilft das nicht, den Zwischenspeicher für die Adresse vollständig leeren.

Bleibt es dabei, gibt der Blick ins Log Aufschluss:

iob logs --lines 100

Meldet der Admin dort einen Fehler zur Node-Version, war der erste Schritt aus diesem Artikel doch nicht erledigt. Für die Fehlersuche im Forum gehört wie immer die Ausgabe von iob diag in den Beitrag.

Fazit

Admin 8 ist ein Wartungsupdate mit sichtbarer Oberfläche. Die Sprünge auf React 19 und MUI 9 bringen im Alltag wenig Neues, halten das Projekt aber auf einer gepflegten Grundlage. Der Sicherheitsfehler bei OAuth2 ist für alle relevant, die ihre Anmeldung darüber laufen lassen.

Der Aufwand liegt in der Vorbereitung. Wer Node.js 22 bereits hat und seine Adapter regelmäßig aktualisiert, merkt vom Update kaum etwas. Wer beides länger liegen ließ, sollte sich einen ruhigen Abend nehmen und mit dem Node-Update anfangen.

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.