Node-RED Dashboard UI — Complete Guide
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-dashboardfrom Manage Palette within the editor, not from npm CLI. - Keep
node-red-dashboardupdated via the editor's palette manager. - Do not use
httpStaticin 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
- Forgetting that lazy evaluation defers computation until the value is forced, causing space leaks with unevaluated thunks
- Using
returnto exit a function early instead of wrapping a pure value in the monad - 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
{{< 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 >}}
DodaTech — a real-time dashboard that delivers.
Built by the developers of DodaTech
Doda Browser, DodaZIP & Durga Antivirus Pro