Skip to content

Node-RED Dashboard UI — Complete Guide

DodaTech Updated 2026-06-24 2 min read

In this tutorial, you'll learn about Node. We cover key concepts, practical examples, and best practices.

Hook

You install the node-red-dashboard palette, create a gauge and a button, and deploy. The widgets appear in the editor's Dashboard tab, but when you open http://localhost:1880/ui, the page shows "Dashboard is loading..." or appears blank.

The Wrong Way

Reinstalling the dashboard palette via npm removes the module but keeps the old configuration, which can cause version conflicts.

# BAD: Removing and reinstalling
npm uninstall node-red-dashboard
npm install node-red-dashboard
Dashboard reinstalled
Same blank page — the issue was not the installation

Reinstalling the same package does not fix configuration or file path issues.

The Right Way

Check the Dashboard configuration, browser console, and server logs.

# 1. Check that the Dashboard module is loaded
curl -s http://localhost:1880/dashboard | head -1
<html><head>...</head><body>...</body></html>

If this returns HTML, the dashboard is serving.

# 2. Check the browser console (F12) for errors
Failed to load resource: http://localhost:1880/dashboard/socket.io/socket.io.js net::ERR_CONNECTION_REFUSED

The Dashboard tried to load Socket.IO but failed.

# 3. Check if socket.io is available
curl -s http://localhost:1880/socket.io/socket.io.js | head -c 100
404 Not Found
# 4. Ensure `httpStatic` is not conflicting in settings.js
# Comment out any httpStatic pointing to a different directory
# 5. Check for port conflicts
sudo lsof -i :1880
# 6. Restart Node-RED cleanly
node-red-stop
node-red-start
Dashboard loaded at http://localhost:1880/ui
Gauge shows live data ✓
Button click sends message ✓

If the Dashboard loads but shows stale data, clear the browser cache or use incognito mode.

Prevention

  • Install node-red-dashboard from Manage Palette within the editor, not from npm CLI.
  • Keep node-red-dashboard updated via the editor's palette manager.
  • Do not use httpStatic in settings.js unless you understand the conflict.
  • Check Socket.IO connectivity after every Node-RED upgrade.
  • Use the Dashboard 2.0 (@flowfuse/node-red-dashboard) for newer projects.

Common Mistakes with red dashboard ui

  1. Forgetting that lazy evaluation defers computation until the value is forced, causing space leaks with unevaluated thunks
  2. Using return to exit a function early instead of wrapping a pure value in the monad
  3. Mixing let bindings with <- bindings in do notation, producing type errors

These mistakes appear frequently in real-world NODE code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

Can I change the Dashboard URL prefix?

Yes — in settings.js, set dashboard ui path to /my-dashboard. The default is /ui. Restart Node-RED after changing.

{{< faq "Why does my gauge show "null" or "--"?">}} The gauge's input is receiving an undefined or null value. Check that the connected node sends a numeric msg.payload. Use a Change node to convert non-numeric values before the gauge. {{< /faq >}}

Can I secure the Dashboard with a login?

Yes — add authentication in settings.js with the adminAuth property. Or use a reverse proxy (Nginx, Caddy) with basic auth in front of the /ui path.


DodaTech — a real-time dashboard that delivers.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro