RedMatic 9 Migration

---

Title: Migration auf RedMatic 9 Category: Administration

Migration auf RedMatic 9

RedMatic 9 ist eine grundlegend verschlankte und modernisierte Version. Das Update von 7.x/8.x funktioniert wie jedes andere Update ("darüber installieren", siehe Update) — aber es gibt einschneidende Änderungen, die man vorher kennen sollte.

Voraussetzungen

• CCU3 mit Firmware ab 3.61.5 oder aktuelles OpenCCU. RedMatic patcht keine Firmware-Dateien mehr, ältere Firmware wird nicht unterstützt.
• Vor dem Update CCU-Backup anlegen und die Flows exportieren.

Was sich ändert

Node.js 24 und Node-RED 5

Bisher Node.js 14 und Node-RED 1.x. Node-RED übernimmt vorhandene Flows beim ersten Start; die meisten Flows laufen unverändert. Zu beachten:

• Der rbe Node ist inzwischen Bestandteil von Node-RED (dort heißt er filter). Ein noch installiertes node-red-node-rbe erzeugt beim Start nur die Warnung "'rbe' already registered" und kann über den Paletten-Manager entfernt werden.
• Function Nodes: Node-RED 5 nutzt aktuelles JavaScript, alter Code läuft in aller Regel weiter. Bei Problemen hilft das Node-RED Log (Log-Level).

Nur noch node-red-contrib-ccu ist vorinstalliert

Dashboard, HomeKit, E-Mail, Sun-Position, Combine, RedMatic-LED, WebApp usw. werden nicht mehr mitgeliefert und nicht mehr von RedMatic gepflegt.

• Bei einem Update von 7.x/8.x bleiben diese Nodes erhalten — sie liegen im Benutzerverzeichnis und laufen weiter. Im Paletten-Manager erscheinen sie wie selbst installierte Nodes und können dort aktualisiert oder entfernt werden.
• Bei einer Neuinstallation müssen benötigte Nodes über den Paletten-Manager installiert werden, z.B. node-red-dashboard bzw. @flowfuse/node-red-dashboard für das Dashboard oder redmatic-homekit für HomeKit.

Der RedMatic-Paketmanager und die RedMatic-WebApp entfallen

Der Reiter "Pakete" in den RedMatic-Einstellungen ist weg. Nodes werden ausschließlich über den Paletten-Manager von Node-RED installiert. Die RedMatic-WebApp ist eingestellt.

Keine nativen Module

Nodes, die bei der Installation Binärmodule compilieren müssen, können auf der CCU nicht installiert werden — es gibt dort keine Compiler-Toolchain, und RedMatic liefert keine vorkompilierten Binaries mehr mit. Das ist eine bekannte und akzeptierte Einschränkung, siehe Nodes mit Binärmodulen.

Weitere Änderungen

• Logging: Die Einstellung logging.ain wird automatisch nach logging.syslog migriert, das Log landet weiterhin im CCU-Syslog.
• Ein noch konfiguriertes midnight-red Theme wird beim ersten Öffnen der RedMatic-Einstellungen entfernt (das Theme wird nicht mehr mitgeliefert).
• Es werden keine Beispiel-Flows mehr mitgeliefert.
• Die Lizenzübersicht wurde durch SBOMs (CycloneDX) ersetzt; sie liegen jedem Release bei und sind in den RedMatic-Einstellungen im Reiter Lizenzen verlinkt.
• git ist weiterhin enthalten (für das Node-RED Projects Feature und npm-Installationen aus git-URLs); jq, jo, ffmpeg und die anderen früher mitgelieferten Tools nicht mehr.