Roadrunner technical documentation Buy on-line

Running Node-RED on RoadRunner

If you are using a Debian Buster 10 microSD then it is possible to install Node-RED using the same script used for Raspberry. This article illustrates how.

The Node-RED comunity provides a script to install Node.js, npm and Node-RED onto a Raspberry Pi. This script can be used also for the RoadRunner. The script can also be used to upgrade an existing install when a new release is available.

Running the following command will download and run the script:

bash <(curl -sL

Running as a service

The install script for the Pi also sets it up to run as a service. This means it can run in the background and be enabled to automatically start on boot.

The following commands are provided to work with the service:

  • node-red-start - this starts the Node-RED service and displays its log output. Pressing Ctrl-C or closing the window does not stop the service; it keeps running in the background
  • node-red-stop - this stops the Node-RED service
  • node-red-restart - this stops and restarts the Node-RED service
  • node-red-log - this displays the log output of the service

Autostart on boot

If you want Node-RED to run when the Pi is turned on, or re-booted, you can enable the service to autostart by running the command:

sudo systemctl enable nodered.service

To disable the service, run the command:

sudo systemctl disable nodered.service

Opening the editor

Once Node-RED is running you can access the editor in a browser: http://roadrunner_ip_address:1880.

Manage the GPIO lines using the node node-red-contrib-roadrunner

node-red-contrib-roadrunner is a node developed by Antonio Galea to the Roadrunner GPIO lines in Node-RED

To install this node open the menu manage pallete inside the Node-RED editor.

then select the tab Install and type node-red-contrib-roadrunner:

press the Install button and wait. At the end you will have two new nodes on the palette list.

If you are running Node-RED as a normal user, be sure to give the necessary permissions to /dev/gpio0. One simple way is to save this text:

KERNEL=="gpiochip0", MODE="0666"

inside a file called:


Then restart Node-RED:

sudo systemctl restart nodered.service




Sergio Tanzilli
System designer, webmaster and Acme Systems co-founder
Personal email:
Webpages: -
Github repositories: and
Telegram group dedicated to the Acme Systems boards:

Roadrunner technical documentation Buy on-line

Bruna Mandolino