If you are using Raspbian, then you must have Raspbian Stretch as a minimum version. Raspbian Buster is the currently supported version.
We provide a script to install Node.js, npm and Node-RED onto a Raspberry Pi. 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. If you want to review the contents of the script first, you can view it here.
bash <(curl -sL https://raw.githubusercontent.com/node-red/linux-installers/master/deb/update-nodejs-and-nodered)
sudo apt install build-essential gitfirst to ensure npm is able to build any binary modules it needs to install.
This script will:
apt-get install noderedand includes the Raspbian-packaged version of Node.js, but does not include
While using these packages is convenient at first, we strongly recommend using our install script above instead.
As with running Node-RED locally, you can use
node-red command to run Node-RED in a terminal. It can then be stopped
Ctrl-C or by closing the terminal window.
Due to the limited memory of the Raspberry Pi, you will need to start Node-RED with an additional argument to tell the underlying Node.js process to free up unused memory sooner than it would otherwise.
To do this, you should use the alternative
node-red-pi command and pass in the
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-Cor 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
You can also start the Node-RED service on the Raspbian Desktop by selecting
Menu -> Programming -> Node-RED menu option.
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
Once Node-RED is running you can access the editor in a browser.
If you are using the browser on the Pi desktop, you can open the address: http://localhost:1880.
When browsing from another machine you should use the hostname or IP-address of the Pi:
can find the IP address by running
hostname -I on the Pi.