selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Node RED logo

Self-host Node RED

4.1.17

Visual flow editor for event-driven app automation

ReleaseOpen SourceApache-2.0
sudo npm install -g node-red
Updated3 weeks ago
LanguageJavaScript
Setup difficultyEasy
Stars
23 850
Port
1880 (Editor UI and Admin API (also serves HTTP In node routes and static content))
Requires
Node.js
Docker
nodered/node-red
Node-RED flow editor canvas with wired nodes and the sidebar

What is Node RED?

Aged but active, Node-RED lets people build event-driven applications by wiring nodes together on a browser canvas instead of writing whole programs. It began life in 2013 as an IBM side-project, went open-source later that year, and today sits under the OpenJS Foundation with an Apache 2.0 licence. The runtime is Node.js based, so the same install works on a low-cost Raspberry Pi at the network edge or on cloud hardware. Core nodes cover message brokers over MQTT, HTTP endpoints, TCP and serial sockets, scheduled injections and debug output, with inline JavaScript logic in Function nodes; over 5,000 community nodes extend the palette further. Flows are plain JSON you import, export and publish to the shared flow library, a built-in library stores reusable functions and templates, and the projects feature keeps flows in a git repository. You install it with one npm command, run the nodered/node-red container with a volume for /data, use the Snap package or the Raspberry Pi script; guides also exist for Windows, BeagleBone boards, Android through Termux, and AWS or Azure. Out of the box the editor is unsecured on your network, so you add a login through adminAuth, enable TLS with your own key and certificate, and set credentialSecret to protect stored node credentials. Version 5.x expects Node.js 22 or newer.

Node RED alternatives

Should you self-host Node RED?

Node RED scores 81/100 on selfhost.directory (how scoring works) and ranks #2 of 26 in Automation. It has 23 850 GitHub stars, +113 in the last 30 days.

It shipped 21 stable releases in the past year. The latest, 4.1.17, came out on 21 October 2026. New versions land roughly every 4 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Huginn (82/100, 50 553 stars). It scores higher overall, so compare the two before you pick. See Node RED vs Huginn side by side.

Features

  • Built-in asset library
  • Customisable editor theme
  • Custom nodes / plugin system
  • Encrypted credential storage
  • HTTP endpoints / webhooks
  • HTTPS Support
  • Import / Export
  • Inline JavaScript functions
  • MQTT messaging
  • Pluggable context storage
  • REST API
  • Subflows
  • User roles and permissions
  • Visual flow editor

Node RED README

How to install Node RED

Install Node RED with Docker

Environment variables
FLOWS, NODE_OPTIONS, NODE_RED_ENABLE_SAFE_MODE, NODE_RED_ENABLE_PROJECTS, NODE_RED_CREDENTIAL_SECRET, TZ

docker run -it -p 1880:1880 --name mynodered nodered/node-red

Persist user data by mounting a volume at /data; images for amd64, arm32v6, arm32v7, arm64v8 and s390x.

How to configure Node RED

  • FLOWSflows.jsonDocker env var: flows configuration file to start with.
  • NODE_OPTIONSDocker env var: Node.js runtime arguments passed to the container.
  • NODE_RED_ENABLE_SAFE_MODEfalseDocker env var: start Node-RED in safe (not running) mode.
  • NODE_RED_ENABLE_PROJECTSfalseDocker env var: start Node-RED with the projects feature enabled.
  • flowFileflows_<hostname>.jsonThe file used to store the flows.

Node RED releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How do I interact with Raspberry Pi GPIO?

The GPIO nodes that used to ship in the Raspberry Pi install were dropped from the Node-RED 1.0 Docker images; the docs now point to node-red-node-pi-gpiod talking to a PiGPIOd daemon.

What versions of Node.js are supported?

Node-RED 5.x needs at least Node.js 22, and the project currently recommends Node 24.x, targeting Active and Maintenance LTS releases.

What is the history of the project?

It began as an IBM side-project in 2013, was open-sourced that September, and is now part of the OpenJS Foundation.

Why is the project called Node-RED?

The FAQ points to the project's About/history page for the origin of the name.

More in Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…