diff --git a/source/_integrations/mqtt.markdown b/source/_integrations/mqtt.markdown index c8ca3721b55..13aa74193d4 100644 --- a/source/_integrations/mqtt.markdown +++ b/source/_integrations/mqtt.markdown @@ -30,8 +30,6 @@ MQTT (aka MQ Telemetry Transport) is a machine-to-machine or "Internet of Things Your first step to get MQTT and Home Assistant working is to choose a [broker](/docs/mqtt/broker). -**Note:** If you use TLS or WebSocket, then manual configuration (see below) is currently the only option. - {% include integrations/config_flow.md %} ## Manual configuration @@ -43,20 +41,10 @@ To connect to your [own MQTT broker](/docs/mqtt/broker#run-your-own): ```yaml # Example configuration.yaml entry mqtt: - broker: "IP_ADDRESS_BROKER" + broker: IP_ADDRESS_BROKER ``` -If your broker requires username / password authentication: - -```yaml -# Example configuration.yaml entry -mqtt: - broker: "IP_ADDRESS_BROKER" - username: "MQTT_USERNAME" - password: !secret MQTT_PASSWORD -``` - -If your broker uses TLS, specify `certificate: auto` or your own CA certificate: +Manual configuration is required when connecting to a broker over TLS. ```yaml # Example configuration.yaml entry @@ -64,22 +52,10 @@ mqtt: certificate: "PATH_TO_CA.crt" broker: "IP_ADDRESS_BROKER" port: 8883 + username: "MQTT_USERNAME" + password: !secret MQTT_PASSWORD ``` -If your broker uses MQTT over WebSocket, specify `transport: websockets` and optionally `ws_path` and `ws_headers` to control the handshake: - -```yaml -# Example configuration.yaml entry -mqtt: - broker: "IP_ADDRESS_BROKER" - transport: websockets - ws_path: "/mqtt" - headers: - authorization: Bearer -``` - -The version of the MQTT protocol can be changed through the `protocol` attribute. - ## Additional features - [Certificate](/docs/mqtt/certificate/)