Node-Red Dashboard -Beginners Guide

dashboard-nodesYou can create a node-red dashboard for IOT and Home automation and for a myriad of other applications.

However the nodes that allow you to do this aren’t part of the core nodes and need to be installed separately.



The node-red-dashboard node is installed using menu>manage palette>search node-red-dashboard>install.

More details are available here if needed.

If you are a developer the latest version of the dashboard node provides an api for creating your own dashboard widgets. details are here.

The node-red-dashboard node installs a collection of nodes under the dashboard category.

You can view dashboards using the same url as node-red admin but with /ui added e.g http://localhost:1800/ui.

Note: The dashboard port is the same as the admin port

The path can be changed in the settings.js file

ui: { path: "ui" },

Creating a Node-Red Dashboard

The easiest way to become familiar with the various dashboard widgets is to create a dashboard using them.

This video shows you how to create a basic dashboard.

Here is the flow used in the video

download

Dashboard Layout

The dashboard layout should be considered as a grid.

The basic element is a widget which are placed in groups.

Group elements have a width in units where,by default, 1 unit =48px wide.

Widgets also have a width which by default is set to auto which means that it will be the width of the group.

The documentation states:

The layout algorithm of the dashboard always tries to place items as high and to the left as they can within their container – this applies to how groups are positioned on the page, as well as how widgets are positioned in a group.

Given a group with width 6, if you add six widgets, each with a width of 2, then they will be laid out in two rows – three widgets in each.

If you add two groups of width 6, as long as your browser window is wide enough, they will sit alongside each other. If you shrink the browser, at some point the second group will shift to be below the first, in a column.

It is advisable to use multiple groups if possible, rather than one big group, so that the page can dynamically resize on smaller screens.

Layout Example

If you change the width of a group then you will see that it has a maximum size. This is effectively the size of the display page.

group-size

The dashboard is filled horizontally so if the max size is 27 and you create two groups each 10 wide then they will it side by side as shown below:

group-layout

 

If you add a third group then it will be placed below as shown below:

group-size-2

Group and Widget spacing

If you look at the screen shot then you can see spaces between groups and widgets the actual space is set on dashboard>site tab.

group-widget-spacing

Adding Widgets

When adding widgets to a group then the size is set to auto by default which means it will fill the width of the group.

However you can change both the vertical and horizontal size. If I place three text widget in group1 and set the size of each to 4 *3

widget-set-size

Now notice how they fit into the group which is 10 units wide. Also notice the widget spacing and how the groups are now positioned on the page.

group-layout-3

Note: Changing the zoom settings on the browser as well as changing the browser window size will affect the display. In addition the screen size of the device you are using will also have an impact so you should test on a variety of devices.

Styling Themes, Groups,Widgets and Widget Elements.

Theme style

There are three options – light,dark,and custom, and this is set on the dashboard>theme tab

theme-style

Styling Groups,Widgets and Widget Elements.

This is done using a template node with the template type set to added to site <head> section.

template-node-styles

The styles defined in this node will be available in all flows.

The following screen shot show use of the template style to create a dashboard.

mosquitto-dashboard

The actual style I got from a forum post here the author was hotNipi and I found lots of useful information there.

I have included the template as a download in case you can’t find it on the forum.

Changing background colour of widgets (buttons, text input)

If the widget has a class property as shown in the screenshot below.

change-background-colour

The you need to create the class using the template node and add the class name to the property as shown above. Here is the code for the class.

.text-background
{
background-color:red !important;

}

You can also do this dynamically using the message object with the className attribute as follows

.text-background
{
msg.className="text-background";
}

Styling Labels and Values

Here is an example flow that consists of an inject node that send a simple text string and a change node to set payload properties for the colours.
set-colored text
The change node is shown below

set-colour-change

The work is done the text node where HTML is used to change the font colour which is passed into the node as variables from the change node.

set-colored text-2

Result

Resources:

Dashboard Template

Common Questions and Answers

Q- Are there additional dashboard nodes available?

A- Yes there are addition dashboard nodes like the table node and they are installed like any other node.

Q- Can I access my dashboard on a mobile phone?

A- Yes it is a web page and can be accessed by a browser on the phone.

Q- Can I access my dashboard over the Internet?

A- Yes but it is important to make it secure. See here for using nginx.You can also setup a VPN and access through that or use VNC.

Resources:

There are additional dashboard nodes available and more are regularly made available. You can find a list here.

Related Tutorials :

Click to rate this post!
[Total: 3 Average: 3.7]

19 comments

  1. Thank you for the wealth of information you provide in a concise and well documented format.

    My latest challenge with the Dashboard UI is not everything refreshes to the latest change.

    Is there a best practice for how to set up a flow and have it run every time the dashboard UI is refreshed?

    Thank you

    1. I assume you mean the dashboard needs to be refreshed? I usually use an inject node and refresh the dashboard every second. Is that what you mean or have I misunderstood.
      Rgds
      Steve

  2. I join the group here in congratulating and thanking Steve for his awesome tutorials, making the learning curve less steep for us all.
    Kudos Steve! Keep up the good work.

  3. Thank you for a very useful tutorial on the Node-RED dashboard. I am just getting into using WeMos and ESP32 modules for home automation and Node-RED is looking to be a good tool for visualizing and controlling devices so the tutorial was spot on!. I am currently using Google Home minis via IFTTT and Adafruit.io to give word commands to WeMos and ESP32 devices (having looked at many less reliable/slower combinations). I am currently looking to replace the Adafruit.io route with Node-RED and Mosquito MQTT running on a Pi. Do you have any recommendations for doing it in a better or more direct way? Regards Steve

    1. Hello !
      I´m doing exactly the same thing, using the same elements.
      If I may, let me suggest to round up your set-up, to also use a mobile app for visualization.
      In my case, after some research, I decided for “MQTT Dashboard”. I have an Android phone so I found it in Play Store. I don´t know whether they vave an iOS version.

  4. I cant get it to display /ui error message is please add som ui nodes but i have them in

    1. Hi
      Can you send me a screen shot of what you are getting using the ask steve page and I’ll take a look
      Rgds
      Steve

  5. If I installed in home directory by accident, can i copy the contents of the created user/node_modules directory into the correct ~/.node-red/node_modules folder?

  6. Great tutorial. Thanks. I read step by step. I fully understood every concept. The illustrations help a lot. Then I saw the video. It enhanced my understanding of the whole thing and every concept. Thanks for your Magnum Opus.

  7. This is a HUGE amount of work you are putting into this site – and tons of people arecbenefiting from it – THANK YOU !

  8. Hi, is it possible for a tutorial on how to access (safely) nodered across the internet with nodered running on raspberry pi. Many thanks.

  9. Hearty Greetings, I am 72 years old retired Telecom Engineer and my hobby is IoT. I go through your article and videos on Node-Red and it is really exhaustive. You expose all most, all the options and features of Node-red and it will be more than enough for some one to master it. Thank you so much for your contribution to beginners like me.
    With Great Regards, Ragothaman R. from India.

  10. Steve,
    Thank you so much for all the work you do in building and continuing to expand your website of information. You present the information in a logical, easy to understand method. Because of that, when you have covered something I’m interested in learning, your site is the first I start with. From your pages I’ve learned enough about Node-Red and MQTT to let me begin to control the tasmota’d sonoff devices.
    Have you dabbled with the programs openHab or HomeAssistant?

    1. Hi
      Tks for the nice comment and glad you find the site helpful.
      I have dabbled with homeassistant and it is on my list of things to do.
      rgds
      Steve

Leave a Reply to steve Cancel reply

Your email address will not be published. Required fields are marked *