MQTT


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.

Configuration

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
mqtt:
  broker: IP_ADDRESS_BROKER

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

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

Additional features