![\"Getting](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Getting-Started-Node-RED-Raspberry-Pi.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nPrerequisites<\/h2>\n\n\n\n
We assume that you are familiar with the Raspberry Pi, you know how to install the operating system, and you know how to establish an SSH connection with your Pi. You can take a look at the following tutorials first:<\/p>\n\n\n\n
- \n
- Getting Started with Raspberry Pi<\/a><\/li>\n\n\n\n
- Install Raspberry Pi OS, Set Up Wi-Fi, Enable and Connect with SSH<\/a><\/li>\n<\/ul>\n\n\n\n
What\u2019s Node-RED?<\/h2>\n\n\n\n
Node-RED<\/a><\/strong> is a powerful open-source tool for building Internet of Things (IoT) applications with the goal of simplifying the programming component.<\/p>\n\n\n\n
Node-RED runs on the web browser and it uses visual programming that allows you to connect code blocks, known as nodes<\/strong>, together to perform a task. The nodes when wired together are called flows<\/strong>.<\/p>\n\n\n
\n![\"node-red](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2016\/09\/Node-RED-overview.png?resize=768%2C459&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWhy is<\/strong><\/strong> Node-RED a great solution?<\/strong><\/h3>\n\n\n\n
- \n
- Node-RED is open source and developed by IBM.<\/li>\n\n\n\n
- The Raspberry Pi runs Node-RED perfectly.<\/li>\n\n\n\n
- It is a visual programming tool, which makes it more accessible to a wider range of users.<\/li>\n\n\n\n
- With Node-RED you can spend more time making cool stuff, rather than spending countless hours writing code.<\/li>\n<\/ul>\n\n\n\n
What can you do with Node-RED?<\/h3>\n\n\n\n
Node-RED makes it easy to:<\/p>\n\n\n\n
- \n
- Access your RPi GPIOs;<\/li>\n\n\n\n
- Establish an MQTT connection with other devices (Arduino, ESP8266, ESP32 etc);<\/li>\n\n\n\n
- Create a responsive graphical user interface for your projects;<\/li>\n\n\n\n
- Communicate with third-party services (IFTTT.com, Adafruit.io, ThingSpeak, Home Assistant, InfluxDB <\/a>etc);<\/li>\n\n\n\n
- Retrieve data from the web (weather forecast, stock prices, emails. etc);<\/li>\n\n\n\n
- Create time-triggered events;<\/li>\n\n\n\n
- Store and retrieve data from a database.<\/li>\n<\/ul>\n\n\n\n
Here\u2019s a library with some examples of flows and nodes<\/a> for Node-RED.<\/p>\n\n\n\n
Installing Node-RED on Raspberry Pi<\/h2>\n\n\n\n
Having an SSH connection established with your Raspberry Pi<\/a>, enter the following to install Node-RED:<\/p>\n\n\n\n
bash <(curl -sL https:\/\/raw.githubusercontent.com\/node-red\/linux-installers\/master\/deb\/update-nodejs-and-nodered)<\/code><\/pre>\n\n\n\nNode-RED is installed by default on the Raspberry Pi OS (32-bit). However, it is recommended to run the previous command to install the required packages and update it to the most recent version. You\u2019ll get a message informing you about this. Press Y<\/strong> and press Enter <\/strong>to accept.<\/p>\n\n\n\n
Node-RED is not installed by default on Raspberry Pi OS (64-bit).<\/p>\n\n\n\n
Then, you’ll be asked: “Would you like to install Pi-specific nodes?” Press Y<\/strong> and Enter<\/strong>.<\/p>\n\n\n\n
It will take a few minutes to install Node-RED. In the end, you should get a similar message on the Terminal window:<\/p>\n\n\n
\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/%E2%80%8CInstall-Node-RED-RaspberryPi.png?resize=653%2C466&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nConfigure Node-RED Settings<\/h3>\n\n\n\n
After installing, it is recommended to configure initial options and settings. Run the following command:<\/p>\n\n\n\n
node-red admin init<\/code><\/pre>\n\n\n\n![\"Configure](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Configure-Node-RED-Settings.png?resize=621%2C386&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n- \n
- Press Enter <\/strong>to create a Node-RED Settings file on \/home\/pi\/.node-red\/settings.js<\/span><\/li>\n\n\n\n
- Do you want to set up user security? Yes<\/strong>.<\/li>\n\n\n\n
- Enter a username and press Enter<\/strong> (you need to remember it later).<\/li>\n\n\n\n
- Enter a password and press Enter <\/strong>(you need to remember it later).<\/li>\n\n\n\n
- Then, you need to define user permissions. We\u2019ll set full access, make sure the full access option is highlighted in blue and press Enter<\/strong>.<\/li>\n\n\n\n
- You can add other users with different permissions if you want. We\u2019ll just create one user for now. You can always add other users later.<\/li>\n\n\n\n
- Do you want to enable the Projects feature? No<\/strong>.<\/li>\n\n\n\n
- Enter a name for your flows file. Press Enter<\/strong> to select the default name flows.json<\/span>.<\/li>\n\n\n\n
- Provide a passphrase to encrypt your credentials file. Learn more about what is a passphrase<\/a>.<\/li>\n\n\n\n
- Select a theme for the editor. Simply press Enter<\/strong> to select default.<\/li>\n\n\n\n
- Press Enter <\/strong>again to select the default text editor.<\/li>\n\n\n\n
- Allow Function nodes to load external modules? Yes<\/strong>.<\/li>\n<\/ul>\n\n\n\n
Node-RED configuration was successful. All settings are saved on settings.js<\/span>.<\/p>\n\n\n\n
Start Node-RED<\/h3>\n\n\n\n
Run the following command to start Node-RED:<\/p>\n\n\n\n
node-red-start<\/code><\/pre>\n\n\n\nYou should get a similar message on the Terminal:<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/node-red-start-terminal.png?resize=671%2C610&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAutostart Node-RED on boot<\/h3>\n\n\n\n
To automatically run Node-RED when the Pi boots up, you need to enter the following command. This means that as long as your Raspberry Pi is powered up, Node-RED will be running.<\/p>\n\n\n\n
sudo systemctl enable nodered.service<\/code><\/pre>\n\n\n\nNow, restart your Pi so the autostart takes effect. The next time the Raspberry Pi restarts, Node-RED will be already running.<\/p>\n\n\n\n
sudo reboot<\/code><\/pre>\n\n\n\nIf, later on, you want to disable autostart on boot, you can run:<\/p>\n\n\n\n
sudo systemctl disable nodered.service<\/code><\/pre>\n\n\n\nFor more information about the installation process, check the official documentation<\/a>.<\/p>\n\n\n\n
Access Node-RED<\/h2>\n\n\n\n
Node-RED runs on port 1880. To access Node-RED open a browser and type the Raspberry Pi IP address followed by :1880. For example:<\/p>\n\n\n\n
192.164.1.106:1880<\/strong><\/code><\/pre>\n\n\n\nTo get your Raspberry Pi IP address, you can run the following command:<\/p>\n\n\n\n
hostname -I<\/strong><\/code><\/pre>\n\n\n\n![\"Get](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Raspberry-Pi-IP-address.png?resize=591%2C193&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter entering the Raspberry Pi IP address followed by :1880 on the web browser, you’ll get access to the Node-RED login page. Log in with the username and password you’ve set previously.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-login-Page.png?resize=797%2C531&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNow, you have access to Node-RED. You can start building your flows.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/node-red-welcome-screen.png?resize=845%2C557&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNode-RED Overview<\/h2>\n\n\n\n
Let\u2019s take a look at the Node-RED visual interface.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-Visual-Interface.png?resize=963%2C607&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNode-RED Interface Main sections<\/h3>\n\n\n\n
The following picture shows the Node-RED main sections labeled.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-Overview.png?resize=963%2C607&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNodes<\/h4>\n\n\n\n
On the left sidebar, you can see a list with a bunch of blocks. These blocks are called nodes<\/strong> and they are separated by their functionality. If you select a node, you can see how it works in the nodes documentation<\/strong> tab.<\/p>\n\n\n\n
Nodes have input and\/or output ports to receive and send information to other nodes. For example, a node receives an input from a previous node, processes that information, and outputs a different message to another node that will do something with that information. The information passed between nodes is called a message<\/strong>.<\/p>\n\n\n\n
Flow<\/h4>\n\n\n\n
The nodes are the building blocks of a flow<\/strong>. You wire nodes together to create a flow that will perform a certain task. A Flow<\/strong> is also a tab in the workspace where you place and organize the nodes.<\/p>\n\n\n\n
In the center, you have the Flow<\/strong> and this is where you place the nodes.<\/p>\n\n\n\n
Right Sidebar<\/h4>\n\n\n\n
The sidebar at the right has several tools.<\/p>\n\n\n\n
- \n
- Information<\/strong>: shows information about the flows;<\/li>\n\n\n\n
- Help<\/strong>: shows the nodes’ documentation;<\/li>\n\n\n\n
- Debug<\/strong>: the bug icon opens a debugging window that shows messages passed to debug nodes\u2014it’s useful for debugging purposes;<\/li>\n\n\n\n
- Config nodes<\/strong>: the gear icon shows information about configuration nodes. Configuration nodes do not appear on the main workspace, and they are special nodes that hold reusable configurations that can be shared by several nodes in a flow.<\/li>\n<\/ul>\n\n\n\n
Deploy<\/h4>\n\n\n\n
The deploy button saves all changes made to the flow and starts running the flow.<\/p>\n\n\n\n
Creating a simple flow<\/h2>\n\n\n\n
To get you used to the Node-RED interface, let’s create a simple flow. The flow we’ll create, simply prints a message to the debug console, when triggered.<\/p>\n\n\n\n
Drag an inject<\/strong> node and a debug<\/strong> node to your flow and wire them together.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-debug-flow.png?resize=433%2C70&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNow, let\u2019s edit the inject node. Double-click the node. In the figure below, you can see the different settings you can change.<\/p>\n\n\n\n
On the msg.payload<\/span> field, select string and type Hello<\/span>. Then, click Done<\/strong>. <\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-edit-inject-node.png?resize=557%2C496&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nMessages (msg<\/span>) in Node-RED are javascript objects that can have multiple properties. The payload<\/span> is the default property most nodes work with. You can think of it as the main content of the message you want to send to the next node. In our case, we’re simply sending a text message.<\/p>\n\n\n\n
We won’t edit the debug node, but you can double-click on it to check its properties.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-edit-debug-node.png?resize=496%2C336&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou can select the output of the debug node, which is msg.payload<\/span> and where we want to send that output. In our case, we want to send it to the debug window.<\/p>\n\n\n\n
To save your application, you need to click the Deploy<\/strong> button in the top right corner.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-deploy-button.png?resize=136%2C35&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYour application is saved.<\/p>\n\n\n\n
Testing the flow<\/h3>\n\n\n\n
Let\u2019s test our simple flow. Open the debug<\/strong> window and click the inject<\/strong> node to trigger the flow.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-Hello-world-example.png?resize=912%2C536&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAs you can see, our message is printed in the debug<\/strong> window when you trigger the inject node. This is a very basic example and it doesn\u2019t do anything useful. However, the purpose of this post is to get you familiar with the Node-RED interface. In no time, you’ll start creating your own flows.<\/p>\n\n\n\n
Exporting and Importing Nodes<\/h2>\n\n\n\n
In this section, you’ll learn how to save your nodes. This is useful if you need to:<\/p>\n\n\n\n
- \n
- Backup<\/strong> your Node-RED flow<\/li>\n\n\n\n
- Move<\/strong> your flow to another Raspberry Pi (or machine)<\/li>\n\n\n\n
- Share<\/strong> your Node-RED project with others<\/li>\n<\/ul>\n\n\n\n
Open the main menu, and select the Export <\/strong>option.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-export-nodes.png?resize=917%2C536&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nA new window opens. You can select if you want to save the selected nodes, the current flow, or all flows. You can also download the nodes as a JSON file or copy the JSON to the clipboard.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/export-nodes-node-red.png?resize=703%2C451&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nTo show you how it works, click on Download <\/strong>for the selected nodes. It will download a JSON file called flows.json<\/span>. <\/p>\n\n\n\n
You can import those nodes later to another Raspberry Pi or another machine with Node-RED installed, by going to the main menu and selecting the Import <\/strong>option.<\/p>\n\n\n\n
On the Import nodes<\/strong> window, you can upload a JSON file or paste raw JSON.<\/p>\n\n\n
\n![\"Import](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/import-flow-node-red.png?resize=703%2C392&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nInstalling Pallete Nodes<\/h2>\n\n\n\n
As we’ve seen previously, Node-RED comes with a bunch of pre-installed nodes on the Pallete (left sidebar). There are many more nodes available that you can install and use for your projects. You can find them in the Node-RED library<\/a>. If you need some specific task for your project, there’s probably already a node for that.<\/p>\n\n\n\n
For example, if you need to add the feature to send an email to your flow, you can google something like this: “send email node-red node”. One of the first search results is this page with the node-red-node-email<\/a>. It comes with some nodes to send and receive emails.<\/p>\n\n\n\n
If you want to install those nodes (or any other nodes) so that you can use them on your flow, go to the main menu and select the option Manage palette<\/strong>.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-manage.palette.png?resize=259%2C547&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThe following window will open. Select the install tab and search for the nodes you want to install, for example, node-red-node-email<\/span>.<\/p>\n\n\n
\n![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Install-Node-RED-Nodes.png?resize=704%2C264&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNode-RED Dashboard<\/h2>\n\n\n\n
Node-RED Dashboard is a module that provides a set of nodes in Node-RED to quickly create a live data dashboard. You can install those nodes using the Menu <\/strong>> Manage Palette<\/strong>. Then, search for node-red-dashboard<\/span> and install it.<\/p>\n\n\n
\n![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Install-Node-RED-dashboard-palette.png?resize=697%2C377&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter installing, the dashboard nodes will show up on the palette.<\/p>\n\n\n
\n![\"Node-RED](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/Node-RED-dashboard-nodes.png?resize=141%2C684&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNodes from the dashboard section provide widgets that show up in your application user interface (UI). The user interface is accessible on the following URL:<\/p>\n\n\n\n
http:\/\/Your_RPi_IP_address:1880\/ui<\/strong>\n<\/code><\/pre>\n\n\n\nFor example, in my case:<\/p>\n\n\n\n
http://192.168.1.106:1880\/ui<\/code><\/pre>\n\n\n\n![\"welcome](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/06\/welcome-node-red-dashboard.png?resize=660%2C420&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAt the moment, you’ll see the previous screen when you access the UI. That’s because you haven’t added any of those dashboard nodes to the flow. We won’t cover how to create a dashboard user interface in this tutorial. If you want to learn more, please read: <\/p>\n\n\n\n
- \n
- Getting Started with Node-RED Dashboard<\/a><\/li>\n<\/ul>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
This tutorial is a quick getting started guide for Node-RED. You learned how to install Node-RED on a Raspberry Pi, how to create a simple flow, import and export nodes, install nodes and install the Node-RED dashboard.<\/p>\n\n\n\n
You can also install Node-RED on a cloud server like Digital Ocean, for example. We have a tutorial about that: Access Node-RED Dashboard from Anywhere using Digital Ocean<\/a>.<\/p>\n\n\n\n
You may also like:<\/p>\n\n\n\n
- \n
- Install InfluxDB 2 on Raspberry Pi<\/a><\/li>\n\n\n\n
- Install Mosquitto MQTT Broker on Raspberry Pi<\/a><\/li>\n\n\n\n
- What is MQTT and How It Works<\/a><\/li>\n<\/ul>\n\n\n\n
Node-RED is very useful for IoT projects that use MQTT, so you may want to check all our MQTT projects: <\/p>\n\n\n\n
- Install Mosquitto MQTT Broker on Raspberry Pi<\/a><\/li>\n\n\n\n
- Install InfluxDB 2 on Raspberry Pi<\/a><\/li>\n\n\n\n
- Move<\/strong> your flow to another Raspberry Pi (or machine)<\/li>\n\n\n\n
- Help<\/strong>: shows the nodes’ documentation;<\/li>\n\n\n\n
- Do you want to set up user security? Yes<\/strong>.<\/li>\n\n\n\n
- Install Raspberry Pi OS, Set Up Wi-Fi, Enable and Connect with SSH<\/a><\/li>\n<\/ul>\n\n\n\n