Node-RED es una de las herramientas más utilizadas dentro del mundo IoT y la automatización debido a su facilidad para conectar dispositivos, APIs y servicios mediante programación visual.
Gracias a Node-RED es posible crear sistemas automatizados sin necesidad de escribir grandes cantidades de código. Actualmente se utiliza en proyectos de domótica, dashboards IoT, automatización industrial e integración con MQTT.
En esta guía aprenderemos cómo instalar Node-RED paso a paso y cómo comenzar a utilizarlo desde cero.
Qué es Node-RED
Node-RED es una plataforma de programación visual desarrollada originalmente por IBM que permite conectar dispositivos, servicios y aplicaciones mediante bloques llamados “nodes”.
En lugar de programar de forma tradicional, Node-RED utiliza flujos visuales que facilitan muchísimo el desarrollo de proyectos IoT.
Actualmente Node-RED se utiliza en:
- proyectos IoT
- automatización industrial
- domótica
- integración de APIs
- sistemas cloud
- dashboards en tiempo real
Además, es totalmente compatible con:
- ESP32
- Arduino
- Raspberry Pi
- MQTT
- Home Assistant
Qué necesitas antes de instalar Node-RED
Antes de empezar necesitas:
- un ordenador con Windows, Linux o macOS
- conexión a Internet
- Node.js instalado
Node.js es necesario porque Node-RED funciona sobre este entorno de ejecución.
Cómo instalar Node.js
Paso 1: entrar en la web oficial
Accede a la página oficial de Node.js y descarga la versión LTS recomendada.

Paso 2: descargar la versión LTS
La versión LTS es la más estable y recomendable para la mayoría de usuarios.
Una vez descargado el instalador, ejecútalo normalmente.
Paso 3: instalar Node.js
Sigue el asistente de instalación dejando las opciones por defecto.
Cuando termine, abre una terminal o CMD y ejecuta el siguiente comando:
node -v
Si aparece un número de versión significa que Node.js se ha instalado correctamente.
Cómo instalar Node-RED
Con Node.js instalado ya podemos instalar Node-RED.
Abre la terminal o CMD y ejecuta el siguiente comando:
npm install -g --unsafe-perm node-red
El proceso puede tardar varios minutos dependiendo de la velocidad del ordenador y de la conexión a Internet.
Cómo iniciar Node-RED
Una vez finalizada la instalación, ejecuta el siguiente comando:
node-red
Si todo funciona correctamente aparecerá un mensaje indicando que Node-RED está funcionando.
Cómo acceder a Node-RED desde el navegador
Con Node-RED funcionando, abre el navegador y entra en:
http://localhost:1880
Ahí aparecerá la interfaz visual de Node-RED.
Primer flujo básico en Node-RED
Una buena forma de empezar es creando un flujo simple utilizando:
- un nodo inject
- un nodo debug
El nodo inject envía información y el nodo debug permite visualizarla.
Para ello:
- Arrastra ambos nodos
- Conéctalos
- Pulsa “Deploy”
- Ejecuta el flujo
Este es el primer paso para entender cómo funciona la lógica de Node-RED.
Node-RED y MQTT
Una de las características más potentes de Node-RED es su integración con MQTT.
Gracias a MQTT es posible:
- enviar datos de sensores
- controlar dispositivos IoT
- automatizar procesos
- conectar sistemas industriales
Si todavía no conoces MQTT puedes leer nuestro artículo:
“Qué es MQTT explicado fácil”.
Ventajas de Node-RED
Muy fácil de usar
Node-RED permite crear automatizaciones complejas de forma visual.
Ideal para principiantes
No es necesario ser programador avanzado para empezar.
Compatible con múltiples dispositivos
Funciona perfectamente con:
- Raspberry Pi
- ESP32
- Arduino
- Home Assistant
Gran comunidad
Existen miles de tutoriales, nodos y ejemplos disponibles.
Errores comunes al instalar Node-RED
No instalar Node.js correctamente
Es uno de los problemas más frecuentes.
Puerto 1880 ocupado
Otro programa puede estar utilizando el puerto necesario para Node-RED.
Problemas de permisos
En algunos sistemas Linux pueden aparecer errores relacionados con permisos de usuario.
Conclusión
Node-RED es una de las mejores herramientas para iniciarse en el mundo IoT y la automatización gracias a su facilidad de uso y enorme flexibilidad.
Actualmente se utiliza tanto en proyectos domésticos como en aplicaciones relacionadas con la Industria 4.0, convirtiéndose en una herramienta muy recomendable para cualquier persona interesada en el Internet de las Cosas.