Actualizado el 31 de marzo de 2026
El broker MQTT es el corazón de cualquier sistema de domótica moderno, actuando como el centro de comunicaciones para todos tus dispositivos IoT. En Home Assistant, el broker por excelencia es Mosquitto, pero un error de configuración común puede dejar tu sistema paralizado: el fallo al iniciar debido a un conflicto de puertos. Este artículo, actualizado para 2026, es la guía definitiva para diagnosticar y solucionar cualquier error del MQTT broker en HassOS, asegurando que tu hogar inteligente funcione a la perfección.
Si bien el artículo original se centraba en un problema específico con una versión obsoleta de HassOS (la 10.0.rc1), el problema de fondo —los conflictos de puertos— sigue siendo tan relevante hoy como entonces. A continuación, te guiaré a través de los métodos actuales para resolverlo de forma limpia y eficiente.
Diagnóstico del Problema: «Error: Cannot create listener…»
El síntoma más común es encontrar en los registros del broker Mosquitto un mensaje de error similar a este:
Error: Cannot create listener on port 1883.
Error: Cannot create listener on port 1884.Este error es inequívoco: el broker intentó arrancar y utilizar sus puertos por defecto (1883 para MQTT estándar y 1884 para WebSockets), pero se encontró con que otro proceso o servicio ya los estaba ocupando. En 2026, con la proliferación de Apps (anteriormente conocidos como Add-ons) que pueden incorporar sus propios servidores, este es un escenario cada vez más frecuente.
Solución Principal 2026: Configurar el Puerto MQTT desde la Interfaz
Atrás quedaron los días de editar archivos de configuración manualmente. Home Assistant ha evolucionado y ahora la gestión de las Apps es mucho más visual e intuitiva. Si te enfrentas a un conflicto de puertos, la solución más limpia es asignar uno nuevo a Mosquitto.
Sigue estos pasos:
- Navega a Ajustes > Apps en tu panel de Home Assistant.
- Busca y selecciona la App «Mosquitto broker».
- Ve a la pestaña «Configuración».
- Aquí verás los puertos de red expuestos. Localiza el puerto que te está dando problemas (por ejemplo, 1883 o 1884) y cámbialo por un número que sepas que está libre. Por ejemplo, puedes probar a cambiar
1884por1885. - Haz clic en «Guardar» y reinicia la App de Mosquitto.
Una vez reiniciado, revisa el registro de la App. Si el error ha desaparecido, ¡has solucionado el problema! Recuerda actualizar la configuración de tus dispositivos (como los que usan Tasmota o ESPHome) para que apunten al nuevo puerto.
Investigación Avanzada: Cómo Identificar Conflictos de Puertos
Si cambiar el puerto no funciona o simplemente quieres saber qué servicio está causando el conflicto, puedes usar la terminal para investigarlo. Para ello, necesitarás tener instalada la App «Terminal & SSH» desde la tienda de Apps.
- Abre la terminal en Home Assistant.
- Ejecuta el siguiente comando para ver todos los servicios que están «escuchando» en diferentes puertos:
netstat -tulpn | grep LISTEN - Examina la salida. Busca las líneas que contengan los puertos en conflicto, como
:1883o:1884. La columna «Program name/PID» te dirá qué proceso está utilizando ese puerto.
Con esta información, podrás identificar si otra App, como Zigbee2MQTT o Z-Wave JS UI, ha activado su propio broker MQTT interno, causando el conflicto. En ese caso, la solución es desactivar el broker interno de esa App o cambiar su puerto, dejando el puerto por defecto libre para Mosquitto.
¿Y el Downgrade? Una Práctica Desaconsejada en 2026
El artículo original sugería hacer un downgrade de HassOS como solución. En 2026, esta es una muy mala idea. Retroceder la versión del sistema operativo puede exponerte a vulnerabilidades de seguridad ya corregidas, causar inestabilidad y romper la compatibilidad con versiones más nuevas de Home Assistant Core y otras Apps. Solo debe considerarse como un último recurso en una situación crítica, y siempre sabiendo los riesgos. Si aún así necesitas hacerlo, he documentado el proceso en mi guía completa sobre downgrades en Home Assistant.
Alternativas al Broker Mosquitto Oficial
Aunque Mosquitto es el estándar de facto, en 2026 existen otras opciones válidas, especialmente las que vienen integradas en otras herramientas populares. Aquí te presento una comparativa:
| Broker | Ventajas | Desventajas |
|---|---|---|
| Mosquitto Broker (App Oficial) | Altamente configurable, robusto, estable y el estándar de la comunidad. Integración perfecta con usuarios de Home Assistant. | Requiere una App separada. Puede entrar en conflicto con otros servicios si no se configura correctamente. |
| Broker de Zigbee2MQTT | Viene integrado, lo que simplifica la instalación si tu uso principal es para Zigbee. Cero configuración adicional. | Menos potente y configurable que Mosquitto. No es ideal si tienes muchos otros dispositivos no-Zigbee que dependen de MQTT. |
| EMQX (App Comunitaria) | Extremadamente potente y escalable, ideal para instalaciones muy grandes o complejas. Incluye un dashboard de gestión muy completo. | Puede ser excesivo para un hogar inteligente estándar. Consume más recursos que Mosquitto. |
Preguntas Frecuentes (FAQ) sobre Errores del MQTT Broker
¿Qué puertos usa MQTT por defecto?
Los puertos estándar son: 1883 para la comunicación MQTT no cifrada, 8883 para MQTT sobre TLS/SSL (cifrado) y 1884 para comunicación a través de WebSockets.
He cambiado el puerto, pero mis dispositivos no se conectan. ¿Qué hago?
Debes actualizar la configuración de cada dispositivo cliente (Tasmota, ESPHome, etc.) para que apunte a la dirección IP de tu Home Assistant y al nuevo puerto que has configurado. Si no lo haces, seguirán intentando conectar al puerto antiguo y fallarán.
¿Necesito un MQTT broker si solo uso ZHA para mis dispositivos Zigbee?
No. La integración ZHA (Zigbee Home Automation) se comunica directamente con el hardware coordinador Zigbee sin necesidad de un intermediario MQTT. Solo necesitarás un broker si usas Zigbee2MQTT o tienes otros dispositivos que sí dependen de este protocolo.
¿Cómo puedo configurar MQTT en Home Assistant desde cero?
El proceso es bastante sencillo. Primero, instalas la App «Mosquitto broker». Luego, en Ajustes > Dispositivos y Servicios, añades la integración «MQTT», que se autoconfigurará para usar el broker que acabas de instalar. Para una guía detallada, puedes consultar mi artículo sobre cómo instalar y configurar Mosquitto Broker en Home Assistant.