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:
If the above My button doesn’t work, you can also perform the following steps manually:
Alternatively, if you want to manually configure MQTT, you will need to add the following to your
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
- Publish & Dump services
- Birth and last will messages
- Testing your setup
Suggest an edit to this page, or provide/view feedback for this page.