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

Manual configuration

Alternatively, if you want to manually configure MQTT, you will need to add the following to your configuration.yaml file.

To connect to your own MQTT broker:

# Example configuration.yaml entry

Manual configuration is required when connecting to a broker over TLS.

# Example configuration.yaml entry
  certificate: "PATH_TO_CA.crt"
  port: 8883
  username: "MQTT_USERNAME"
  password: !secret MQTT_PASSWORD

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.