Node-RED is a graphical, flow-based tool for connecting devices and automating workflows. With RevPi Nodes Runtime, 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 packages revpi-nodered and noderedrevpinodes-server.

▷ Select Configure to switch to Node-RED menu.

Starting Node-RED #

The Cockpit menu Node-RED includes an integrated user management for authenticated access to the Node-RED editor.

▷ 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 this 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.

Important

You can use Node-RED without authentification, but in this case, anyone with network access to your RevPi can access the Node-RED editor.

Expert Mode #

Expert Mode for experienced users enables direct editing of the Node-RED settings.js using the integrated code editor.

Important
  • Incorrect changes to the settings.js file may prevent Node-RED from starting properly.

  • Do not modify the options uiHost and uiPort as they are managed externally.

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.

RevPi Nodes Runtime #

With the RevPi Nodes runtime environment, specific nodes in the Node-RED editor can be used for the inputs and outputs of the RevPi. This feature is enabled automatically because it is required for using RevPi nodes in Node-RED.