Update mqtt.markdown

This commit is contained in:
Paulus Schoutsen 2018-09-12 16:05:51 +02:00 committed by GitHub
parent f6aed097e8
commit a16cedbe4f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -11,19 +11,14 @@ logo: mqtt.png
ha_category: Hub
featured: true
ha_release: pre 0.7
ha_iot_class: depends
ha_iot_class: local push
---
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](/docs/mqtt/broker).
To integrate MQTT into Home Assistant, add the following section to your `configuration.yaml` file. Keep in mind that the minimal setup will run with [an embedded MQTT broker](/docs/mqtt/broker#embedded-broker):
```yaml
# Example configuration.yaml entry
mqtt:
```
To integrate MQTT into Home Assistant, add the following section to your `configuration.yaml` file.
To connect to your [own MQTT broker](/docs/mqtt/broker#run-your-own):
@ -33,9 +28,15 @@ mqtt:
broker: IP_ADDRESS_BROKER
```
<p class='note'>
The minimal setup uses the embedded MQTT broker, however a separate broker is advised for more stability.
</p>
You can also use the [embedded MQTT broker](/docs/mqtt/broker#embedded-broker). A separate broker is advised for more stability.
```yaml
# Example configuration.yaml entry
mqtt:
password: hello
```
This allows you to connect to the MQTT broker with user `homeassistant` and password `hello`.
## {% linkable_title Additional features %}