MQTT (aka MQ Telemetry Transport) is a machine-to-machine or “Internet of Things” connectivity protocol on top of TCP/IP. It allows extremely lightweight publish/subscribe messaging transport.

Your first step to get MQTT and Home Assistant working is to choose a broker.


Adding MQTT to your Home Assistant instance can be done via the user interface, by using this My button:

Manual configuration steps

Advanced broker configuration

Some broker configuration options can’t be set via the user interface, but require changes of your configuration.yaml file. This includes configuring SSL certificate options.

Additional features

Event event_mqtt_reloaded

Event event_mqtt_reloaded is fired when Manually configured MQTT entities have been reloaded and entities thus might have changed.

This event has no additional data.