Node Installation - rdmtc/RedMatic GitHub Wiki
Node-RED kann durch zusätzliche Nodes erweitert werden, eine große und aktive Community hat weit über 1000 Nodes entwickelt die unterschiedlichste Anwendungsfälle abdecken und diverse Services und Systeme an Node-RED anbinden.
Ab RedMatic 9 ist nur noch node-red-contrib-ccu vorinstalliert — alles andere (Dashboard, HomeKit, E-Mail, …) wird bei Bedarf wie hier beschrieben installiert.
- Verzeichnis aller verfügbarer Nodes auf nodered.org
- Erfolgreich auf RedMatic getestete Nodes (bitte ergänzen!)
- Zur Sicherheit vor dem Installieren zusätzlicher Nodes ein CCU Backup anlegen!
- Die Installation braucht eine Internetverbindung der CCU (npm lädt die Pakete von registry.npmjs.org).
- Fehlerhafte Nodes können im schlimmsten Fall zum Node-RED Absturz direkt beim Start führen, falls dieses Problem auftritt kann man diese im Safe Mode wieder entfernen.
- Falls der Safe Mode nicht die erwarteten Ergebnisse liefert, kann man einen Node auch per Hand entfernen (siehe unten, Kommandozeile). Vorher ein CCU Backup machen!
Menü (oben rechts) → Palette verwalten → Reiter Installieren → Node suchen → Installieren.


Über den Reiter Nodes des Paletten-Managers lassen sich installierte Nodes auch aktualisieren oder wieder entfernen. Das gilt nach einem Update von RedMatic 7.x/8.x auch für die früher mitgelieferten Nodes (Dashboard, HomeKit, …), siehe Migration auf RedMatic 9.
RedMatic bringt npm mit. Nach dem Einloggen per ssh:
source /usr/local/addons/redmatic/home/.profile
cd /usr/local/addons/redmatic/var
npm install <paket-name>
Entfernen entsprechend mit npm uninstall <paket-name>. Die für die CCU passenden npm-Einstellungen (keine package-lock.json, Abhängigkeiten pro Node gebündelt) sind in /usr/local/addons/redmatic/etc/npmrc hinterlegt und werden automatisch verwendet. Nach Änderungen an der Kommandozeile Node-RED neu starten.
Manche Nodes brauchen Binärmodule (native Module, z.B. serialport, sqlite3, Bluetooth-Bibliotheken). RedMatic liefert seit Version 9 keine vorkompilierten Binärmodule mehr mit, und auf der CCU bzw. OpenCCU gibt es keine Compiler-Toolchain. Das ist eine bekannte und akzeptierte Einschränkung. Betroffen sind u.a. Nodes die direkt auf Hardware zugreifen (serielle Schnittstellen, Bluetooth, GPIO).
Viele dieser Module bringen aber selbst fertige Binaries für gängige Plattformen mit. Auf OpenCCU mit aarch64 oder x86_64 klappt die Installation deshalb oft trotzdem, node-red-node-serialport lässt sich dort z.B. normal über den Paletten-Manager installieren. Auf der CCU3 passen diese fertigen Binaries meist nicht.
Schlägt die Installation fehl, stehen im Log Meldungen wie diese:
npm error gyp ERR! build error
npm error gyp ERR! stack Error: not found: make
Auswege:
- Das Modul auf einem PC selbst bauen und auf die CCU kopieren: Nodes mit Binärmodulen selbst bauen.
- Häufig gibt es zum gleichen Zweck einen rein in JavaScript implementierten Node, oder die Hardware wird an einem anderen Rechner betrieben und per MQTT angebunden (z.B. zigbee2mqtt auf einem separaten Rechner statt eines ZigBee-Sticks an der CCU).
- Node-RED selbst lässt sich auf einem separaten System betreiben und über node-red-contrib-ccu mit der CCU verbinden.
V 0.0.1 (sagt vielleicht schon alles?).
Mja, Node-RED krankt (wie imho auch andere Smart Home Software oder generell Open Source Frameworks mit Plugin-Konzept) an der sehr unterschiedlichen Qualität der Plugins/Adapter/Bindings/Nodes/Treiber/... Die Bandbreite reicht von "ohne Doku hingeworfen, keinerlei Support, keine Updates" bis zu "Super getestet, ausführlichst dokumentiert, spitzen Support, regelmäßige Updates" ;-)
Als Tipp um die Qualität von sowas zu beurteilen würde ich raten: Github Seite anschauen. Das Projekt sollte schon ein gewisses Alter haben, der letzte Commit sollte aber auch nicht allzu lange her sein, Issue Tracker anschauen - wird anständig supportet - wird auf Issues reagiert und wie lange lässt sich der Entwickler dafür Zeit? Wird es überhaupt von einer Nennenswerten Anzahl Usern benutzt (Github Issues, Github Sternchen, Download Counter auf flows.nodered.org)? Gibt/gab es Pull Requests (sprich: beteiligen sich Leute am Projekt oder ist es eine 1-Man-Show)?, gibt es eine ordentliche Doku/Readme? Auch ein guter Hinweis auf die Aktivität des Entwicklers ist seine Github-Profilseite, da gibts es diese Grafik mit den grünen Kästchen von der Du ablesen kannst wie aktiv der Entwickler insgesamt auf Github war/ist und auch ein Blick auf seine evtl. anderen Projekte schadet nicht.
Auch ganz praktisch: https://npms.io/ scannt alle Node-Module (auch alle Node-RED Nodes sind da zu finden) und erstellt 3 Bewertungen: Popularität, Qualität und Maintenance, was dort angezeigt wird ist meistens recht treffend, jedenfalls was Qualität und Maintenance angeht, Popularität ist bei so Smart Home Sachen meistens sehr niedrig und daher eher weniger aussagekräftig.
(ursprünglich aus https://homematic-forum.de/forum/viewtopic.php?f=41&t=43508&p=446462#p446462)