Instal·lació de Node-RED

Dues peces: el servidor i l'editor

• El servidor és el procés node-red que instal·lem i arrenquem. Executa els fluxos i escolta pel port 1880.
• L'editor és la pàgina web que el servidor ofereix a http://localhost:1880. El navegador només és la pantalla: si tanques la pestanya, els fluxos continuen funcionant.

Per això Node-RED es pot instal·lar en una Raspberry Pi sense pantalla i editar-lo des d'un altre ordinador.

Quina versió de Node.js cal

Dades de nodered.org (juny 2026), que recomana la versió 24.x de Node.js. En escriure aquesta pàgina (octubre 2026) la darrera versió de Node-RED a npm és la 5.0.7. L'script d'instal·lació de Linux exigeix almenys Node.js 22.9.0. No fa servir versions imparells (23, 25…): no es proven.

Altres Linux (Fedora, CentOS…) tenen un script RPM al mateix repositori, i qualsevol sistema amb Node.js pot fer sudo npm install -g node-red. Les pràctiques següents funcionen igual amb qualsevol camí.

1. Eines de compilació

sudo apt install build-essential git curl

Sense elles, Node-RED s'instal·la, però més endavant fallarà la instal·lació de nodes addicionals que porten parts binàries per compilar. curl és per descarregar l'script.

2. L'script instal·lador

curl -sL https://github.com/node-red/linux-installers/releases/latest/download/install-update-nodered-deb -o install-nodered.sh
less install-nodered.sh
bash install-nodered.sh

bash <(curl -sL https://github.com/node-red/linux-installers/releases/latest/download/install-update-nodered-deb)

Per què llegir-lo abans? L'script s'executa amb privilegis d'administrador. El repositori mateix recomana inspeccionar-lo. És un bon hàbit amb qualsevol curl | bash.

Què fa:

• Si no troba Node.js, instal·la la versió 24 LTS. Si en troba una de ≥ 22.9, la deixa. Si és més antiga, l'elimina i en posa una de nova.
• Elimina el nucli antic de Node-RED (conserva les teves dades) i instal·la l'última versió amb npm.
• Afegeix les ordres node-red-start, node-red-stop, node-red-log… i el servei systemd.
• Pregunta si vols instal·lar els nodes específics de la Raspberry Pi. A un Debian normal, respon n.

Opcions útils de l'script

3. Arrencar com a servei

sudo systemctl enable nodered    # arrenca sol quan s'engega l'ordinador
sudo systemctl start nodered     # arrenca ara
node-red-log                     # mostra el log del servei

Com que és un servei, continua funcionant encara que tanquis el terminal. També pots fer servir node-red-start, que l'arrenca i en mostra el log; Ctrl-C només et treu del log, no l'atura.

Només a la Raspberry Pi

• Pots editar des d'un altre ordinador: al navegador, http://<nom-o-IP-de-la-Pi>:1880. La IP la veus a la Pi amb hostname -I.
• Amb poca memòria, arrenca Node-RED amb node-red-pi --max-old-space-size=256 perquè Node.js alliberi memòria abans.
• Node.js 24 no té versions de 32 bits: a una Pi Zero o 1 (armv6) l'script es limita a Node.js 22.

Opcions de la línia d'ordres

1. Instal·lar Node.js

Descarrega la versió LTS des de nodejs.org, executa l'MSI i accepta les opcions per defecte. Quan acabi, tanca i torna a obrir PowerShell perquè agafi les variables d'entorn noves.

node --version; npm --version

Si veus dos números de versió, tot va bé. (Alternativa amb Chocolatey: paquet nodejs-lts.)

2. Instal·lar i executar Node-RED

npm install -g node-red
node-red

A Windows no es posa sudo. L'ordre node-red escriu el log al terminal: cal mantenir-lo obert, i Ctrl-C atura el servidor. La primera vegada es crea la carpeta de dades .node-red dins la teva carpeta d'usuari. Si Windows mostra un avís del tallafocs per a Node.js, decideix conscientment si vols permetre l'accés des de la xarxa (vegeu l'apartat de seguretat).

Arrencar automàticament (opcional)

Per a un ús més permanent, el Programador de tasques de Windows pot executar C:\Users\<usuari>\AppData\Roaming\npm\node-red.cmd "en iniciar el sistema". Amb PM2 també es pot mantenir sempre en marxa i gestionar-ne el log. A classe no ho necessitem.

L'ordre bàsica

docker run -d -p 1880:1880 -v node_red_data:/data --name mynodered nodered/node-red

docker logs -f mynodered     # veure el log
docker stop mynodered        # aturar
docker start mynodered       # tornar-lo a engegar
docker pull nodered/node-red # baixar la imatge nova (per actualitzar, cal recrear el contenidor)

Amb Docker Compose

services:
  node-red:
    image: nodered/node-red:latest
    container_name: mynodered
    restart: unless-stopped
    environment:
      - TZ=Europe/Madrid
    ports:
      - "1880:1880"
    volumes:
      - node-red-data:/data

volumes:
  node-red-data:

Es posa en marxa amb docker compose up -d. Parteix de l'exemple de la documentació; hi he afegit restart i la zona horària.

1. L'editor respon

Obre el navegador a http://localhost:1880/. Hauries de veure l'editor, amb un espai de treball buit (Flux 1) i la paleta de nodes a l'esquerra.

Si no s'obre, mira el log: normalment hi ha l'explicació (vegeu "Troba l'error" a la pestanya d'exercicis).

2. Saber llegir el log

4 Oct 21:56:16 - [info] Node-RED version: v5.0.7
4 Oct 21:56:16 - [info] Node.js  version: v22.22.2
4 Oct 21:56:16 - [info] Linux 6.18.44-fc-v64 x64 LE
4 Oct 21:56:16 - [info] Settings file  : /root/.node-red/settings.js
4 Oct 21:56:16 - [info] User directory : /root/.node-red
4 Oct 21:56:16 - [info] Flows file     : /root/.node-red/flows.json
4 Oct 21:56:16 - [info] Server now running at http://127.0.0.1:1880/
4 Oct 21:56:16 - [info] Starting flows

(Exemple de l'execució real a Linux; als teus sistemes els camins seran uns altres.)

3. Un flux mínim: Inject → Debug

Al menú (≡) tria Importa (Ctrl+I), enganxa això i prem Importa:

[{"id":"a1b2c3d4e5f60001","type":"inject","z":"f6f2187d.f17ca8","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"","payloadType":"date","x":140,"y":80,"wires":[["a1b2c3d4e5f60002"]]},{"id":"a1b2c3d4e5f60002","type":"debug","z":"f6f2187d.f17ca8","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","targetType":"msg","statusVal":"","statusType":"auto","x":330,"y":80,"wires":[]}]

1. Prem Desplega (el botó vermell de dalt a la dreta).
2. Obre la pestanya Debug (la icona de l'insecte, a la barra lateral).
3. Fes clic al quadradet de l'esquerra del node inject.

Al panell de depuració apareix msg.payload amb un nombre molt gran: l'instant actual en mil·lisegons (la marca de temps). Aquest flux (provat en un Node-RED 5.0.7 real) és tot el que cal per saber que el servidor, l'editor i els fluxos funcionen.