Node-RED is a graphical, flow-based tool for connecting devices and automating workflows. With the runtime noderedrevpinodes-server, specific nodes in the Node-RED editor can be used for the inputs and outputs of the RevPi.
Installing Packages for Node-RED #
▷ Open the Cockpit menu Revolution Pi.
▷ Select Install next to the RevPi App Node-RED to install the packages revpi-nodered and noderedrevpinodes-server.
❯❯ This can take a few minutes. The successful installation is displayed.
Starting Node-RED #
The Cockpit menu Node-RED provides a centralized configuration interface for managing Node-RED on the RevPi.
▷ Select Configuration to open the Cockpit menu Node-RED.
The colored dot indicates the status of the RevPi Node-RED service:
-
red: service inactive
-
yellow: service initializing
-
green: service active
▷ Add one or more Node-RED users with a secure password and a role (Read or All access rights).
-
All Node-RED users have access to the same Node-RED work environment for your RevPi.
-
Node-RED users are independent from the user accounts for your Revolution Pi system.
▷ Select Apply Settings.
▷ Enable the main toggle at the top right to initialize RevPi Node-RED service.
▷ Select Open Node-RED or use App URL to access Node-RED editor.
❯ A security warning may appear in your browser twice.
▷ Accept the security exception in each case to continue with the login process.
▷ Log in using the access details you created earlier.
|
Caution
|
Security Risk
When authentication is disabled, anyone on the network can access the Node-RED editor. |
RevPi Nodes Runtime #
With the runtime noderedrevpinodes-server, specific nodes in the Node-RED editor can be used for the inputs and outputs of the RevPi. The runtime starts automatically as soon as you enable the main toggle for the Node-RED service in the top right.
Advanced Settings #
Serial Interface Permissions #
Enables Node-RED to access the serial interfaces of the Revolution Pi system (e.g. RS485, Modbus RTU).
Enabling/disabling restarts the Node-RED service.
Audio and Video Permissions #
Enables permission to use audio and video devices on the RevPi in Node-RED.
Enabling/disabling restarts the Node-RED service.
Extended System Protection #
|
Caution
|
Security Risk
Disabling extended system protection may pose security risks and is not covered by KUNBUS Support. |
This security feature restricts Node-RED access to essential areas. When enabled, system files are write-protected and sensitive directories (/boot, /home, /root) are completely blocked. Kernel components are protected against modification.
Changes are then limited to:
-
/var/lib/revpi-nodered -
/tmp
Enabling/disabling restarts the Node-RED service.
Expert Mode #
Expert mode allows direct editing of settings.js for Node-RED via an integrated code editor.
|
Caution
|
|
Use Load Node-RED defaults to restore the default version of the settings.js file if needed.
Changes made in the code editor are preserved when leaving Expert Mode.