Mosquitto Broker en Home Assistant: guía 2026

Albert BarnosellEditor y responsable de Tecnoyfoto

Instalar Mosquitto Broker es el paso que permite que Home Assistant, Zigbee2MQTT, Tasmota y muchos dispositivos IoT intercambien mensajes por MQTT. En esta guía vas a instalarlo con el método recomendado en Home Assistant OS, conectar la integración MQTT, crear un usuario seguro para tus dispositivos y comprobar que realmente funciona.

La guía está actualizada a 2026. Si llegas desde un tutorial antiguo, olvida las pantallas de Supervisor y Add-on Store: desde Home Assistant 2026.2 los complementos se llaman Apps. Tampoco necesitas crear mqtt.yaml para conectar Home Assistant con el broker.

Qué es Mosquitto y por qué MQTT necesita un broker

MQTT funciona con un modelo de publicación y suscripción. Un dispositivo publica un mensaje en un topic, otro se suscribe a ese topic y el broker se encarga de recibir y repartir los mensajes. Mosquitto es ese intermediario: ligero, local, de código abierto y ampliamente utilizado con Home Assistant.

Conviene distinguir dos piezas que suelen confundirse:

App Mosquitto broker: es el servidor MQTT que recibe y distribuye los mensajes.
Integración MQTT: es la conexión que permite a Home Assistant comunicarse con el broker y crear dispositivos y entidades.

Si todavía estás preparando tu instalación, empieza por la guía para configurar Home Assistant correctamente. Para profundizar después en topics, payloads, QoS, retain y discovery tienes la guía de configuración MQTT paso a paso y la guía avanzada de integración MQTT de calidad Platinum.

Antes de instalar Mosquitto Broker

Comprueba el tipo de instalación. El método de esta guía requiere Home Assistant OS. En Home Assistant Container debes ejecutar Mosquitto en otro contenedor o servidor y conectar después la integración MQTT a su dirección IP.
Actualiza Home Assistant. Si tienes una versión antigua, sigue primero el procedimiento para actualizar Home Assistant de forma segura.
Crea una copia de seguridad. Especialmente importante si ya utilizabas otro broker o vas a reinstalar Mosquitto. Aquí tienes la guía de copias de seguridad de Home Assistant en Google Drive.

Cómo instalar Mosquitto Broker en Home Assistant OS

1. Instala la app oficial

Abre Ajustes > Apps.
Pulsa Instalar app.
Busca Mosquitto broker y abre la ficha oficial.
Pulsa Instalar y espera a que termine.
Inicia la app y revisa su registro. Si no aparecen errores, activa el inicio automático y la vigilancia para que Home Assistant la mantenga disponible.

No copies usuarios y contraseñas de Internet. Home Assistant genera credenciales internas seguras para comunicarse con la app oficial y las mantiene ocultas. La configuración predeterminada de Mosquitto es suficiente para la mayoría de instalaciones domésticas.

2. Crea un usuario para los dispositivos MQTT

Home Assistant puede conectarse automáticamente al broker, pero un dispositivo externo —por ejemplo Tasmota, Zigbee2MQTT ejecutado en otra máquina o un programa de pruebas— necesita sus propias credenciales.

Ve a Ajustes > Personas > Usuarios.
Crea un usuario local dedicado, por ejemplo mqtt_dispositivos.
Asigna una contraseña larga, única y aleatoria.
No le des permisos de administrador.

Si no aparece la opción para crear usuarios, activa el modo avanzado en tu perfil. No utilices homeassistant ni addons como nombre: están reservados por el sistema. Si guardas credenciales en YAML, protégelas siguiendo la guía de secrets.yaml para Home Assistant.

3. Añade la integración MQTT

Abre Ajustes > Dispositivos y servicios.
La integración MQTT debería aparecer como descubierta. Pulsa Configurar.
Mantén habilitado el descubrimiento MQTT, salvo que tengas una razón concreta para desactivarlo.
Confirma la configuración. Home Assistant asignará sus credenciales internas automáticamente.

Si MQTT no aparece como descubierto, comprueba que Mosquitto está iniciado, espera uno o dos minutos y recarga la página. También puedes pulsar Añadir integración, buscar MQTT y configurar manualmente el host, el puerto y las credenciales del broker.

Qué datos necesita un dispositivo para conectarse

Dato	Valor habitual
Servidor o broker	La dirección IP local de Home Assistant
Puerto MQTT	`1883` dentro de una red local de confianza
Usuario	El usuario local dedicado que acabas de crear
Contraseña	La contraseña única de ese usuario
Client ID	Un identificador diferente para cada cliente
Discovery prefix	`homeassistant`, salvo que lo hayas cambiado

El puerto 1883 no cifra el tráfico. Puede utilizarse en una LAN doméstica bien protegida, pero no debes abrirlo directamente a Internet. Para conexiones entre redes utiliza TLS o una VPN y aplica las recomendaciones de la guía de seguridad en Home Assistant.

Cómo comprobar que Mosquitto funciona

No hace falta instalar herramientas externas para una prueba básica:

Entra en Ajustes > Dispositivos y servicios.
Abre la integración MQTT y pulsa Configurar.
En Escuchar un topic, escribe tecnoyfoto/prueba y empieza a escuchar.
En Publicar un paquete, utiliza el topic tecnoyfoto/prueba y el payload hola mqtt.
Publica el mensaje. Si aparece en el panel de escucha, broker e integración están comunicándose correctamente.

Que el mensaje llegue no significa que aparezca automáticamente una entidad. Para eso el dispositivo debe enviar un mensaje de MQTT Discovery válido o debes crear el dispositivo manualmente desde la integración o mediante YAML. La guía de MQTT Platinum explica cómo estructurar discovery, disponibilidad y entidades estables.

Mosquitto con Zigbee2MQTT, Tasmota y ESPHome

Una vez probado el broker puedes conectarle otros servicios. Utiliza siempre la IP local de Home Assistant, el puerto configurado y un usuario dedicado:

Zigbee2MQTT: consulta la guía para instalar Zigbee2MQTT en Home Assistant y, antes de una actualización importante, la guía para actualizar Zigbee2MQTT sin perder la configuración.
Tasmota: introduce los datos del broker en la configuración MQTT del dispositivo. La guía de instalación de Tasmota explica el resto del proceso.
ESPHome: normalmente utiliza su API nativa con Home Assistant y no necesita MQTT. En qué es ESPHome y para qué sirve puedes decidir qué método encaja mejor.

Errores frecuentes y cómo solucionarlos

MQTT aparece desconectado

Revisa primero el registro de la app Mosquitto. Comprueba que el host y el puerto sean correctos, que el usuario exista y que ningún otro cliente esté usando el mismo Client ID. Home Assistant requiere un broker compatible con MQTT 5; la app oficial Mosquitto lo es.

El dispositivo conecta, pero no aparecen entidades

Comprueba que discovery esté activado y escucha homeassistant/#. Si no llega una configuración de descubrimiento, el problema está en el dispositivo o en su topic, no en Mosquitto. Para los casos más habituales consulta la guía para solucionar errores del broker MQTT.

Error de certificado SSL

Si aparece CERTIFICATE_VERIFY_FAILED, revisa el certificado y el nombre del servidor. En la reconfiguración de MQTT, la validación del certificado puede dejarse en Auto cuando se utiliza una autoridad de confianza. No desactives la validación como solución permanente sin entender el riesgo.

Mosquitto dejó de funcionar después de reinstalarlo

La integración de Home Assistant actualiza automáticamente su contraseña interna después de reinstalar la app, pero debes restaurar o volver a crear los usuarios adicionales que utilizaban tus dispositivos. Por eso conviene guardar una copia de las opciones de usuario antes de reinstalar.

Configuraciones antiguas que ya no necesitas

No necesitas declarar la conexión al broker en configuration.yaml cuando utilizas la integración configurada desde la interfaz.
No necesitas crear un archivo mqtt.yaml solo para instalar Mosquitto.
No reutilices usuarios y contraseñas publicados en ejemplos antiguos.
No actives configuración personalizada ni ACL avanzadas si no las necesitas.
No expongas los puertos 1883 o 1884 directamente a Internet.

Preguntas frecuentes

¿Mosquitto y MQTT son lo mismo?

No. MQTT es el protocolo de comunicación y Mosquitto es un broker que implementa ese protocolo.

¿Necesito Mosquitto para usar Home Assistant?

No. Solo lo necesitas cuando un dispositivo o servicio utiliza MQTT. Muchas integraciones se comunican por otros protocolos.

¿Puedo usar un broker instalado en otro equipo?

Sí. Añade la integración MQTT manualmente e introduce la IP o el nombre del servidor, puerto y credenciales del broker externo.

¿Debo activar retain en todos los mensajes?

No. Retain hace que el broker conserve el último mensaje de un topic para entregarlo a nuevos suscriptores. Es útil en estados y configuraciones de discovery, pero puede producir estados antiguos si se utiliza sin criterio.

Conclusión

La instalación recomendada en Home Assistant OS es sencilla: instala la app oficial Mosquitto, deja que Home Assistant configure sus credenciales internas, crea un usuario dedicado para los clientes externos, añade la integración MQTT y realiza una prueba de publicación y escucha. Con esta base ya puedes integrar dispositivos sin depender de la nube y ampliar tu sistema con Zigbee2MQTT o Tasmota.

Documentación de referencia: integración MQTT de Home Assistant y documentación oficial de la app Mosquitto broker.

Continúa leyendo