jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-17 14:26:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update MQTT broker docs for clarity (#3573)

Browse Source 
* Update MQTT broker docs for clarity

Adding words to note that the reason a "run your own" broker is the most private is because the embedded broker doesn't support TLS/SSL.
Also updating to use the new configuration tags.

* Update to reference hbmqtt supporting TLS
This commit is contained in:
DubhAd 2017-10-11 07:22:47 +01:00 committed by Fabian Affolter
parent 5985eeeea9
commit 263db7b6e9
1 changed files with 50 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
source/_docs/mqtt/broker.markdown
View File

@ -18,7 +18,7 @@ The MQTT component needs you to run an MQTT broker for Home Assistant to connect
Home Assistant contains an embedded MQTT broker. If no broker configuration is given, the [HBMQTT broker](https://pypi.python.org/pypi/hbmqtt) is started and Home Assistant connects to it. Embedded broker default configuration: Home Assistant contains an embedded MQTT broker. If no broker configuration is given, the [HBMQTT broker](https://pypi.python.org/pypi/hbmqtt) is started and Home Assistant connects to it. Embedded broker default configuration:
| Setting | Value | | Setting | Value |
| ------- | ----- | | -------------- | ----- |
| Host | localhost | Host | localhost
| Port | 1883 | Port | 1883
| Protocol | 3.1.1 | Protocol | 3.1.1
@ -51,7 +51,7 @@ mqtt:
### {% linkable_title Run your own %} ### {% linkable_title Run your own %}
This is the most private option but requires a bit more work. There are multiple free and open-source brokers to pick from: eg. [Mosquitto](http://mosquitto.org/), [EMQ](http://emqtt.io/), or [Mosca](http://www.mosca.io/). Along with the embedded broker this is the most private option, but it requires a bit more work. There are multiple free and open-source brokers to pick from: eg. [Mosquitto](http://mosquitto.org/), [EMQ](http://emqtt.io/), or [Mosca](http://www.mosca.io/).
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
@ -61,16 +61,48 @@ mqtt:
Configuration variables: Configuration variables:
- **broker** (*Optional*): The IP address or hostname of your MQTT broker, e.g. 192.168.1.32. {% configuration %}
- **port** (*Optional*): The network port to connect to. Default is 1883. broker:
- **client_id** (*Optional*): The client ID that Home Assistant will use. Has to be unique on the server. Default is a randomly generated one. required: false
- **keepalive** (*Optional*): The time in seconds between sending keep alive messages for this client. Default is 60. description: The IP address or hostname of your MQTT broker, e.g. 192.168.1.32.
- **username** (*Optional*): The username to use with your MQTT broker. type: string
- **password** (*Optional*): The corresponding password for the username to use with your MQTT broker. port:
- **protocol** (*Optional*): Protocol to use: 3.1 or 3.1.1. By default it connects with 3.1.1 and falls back to 3.1 if server does not support 3.1.1. required: false
- **certificate** (*Optional*): Path to the certificate file, eg. `/home/user/.homeassistant/server.crt`. description: The network port to connect to. Default is 1883.
- **tls_insecure** (*Optional*): Set the verification of the server hostname in the server certificate. type: int
- **tls_version** (*Optional*): TLS/SSL protocol version to use. Available options are: `auto`, `1.0`, `1.1`, `1.2`. Defaults to `auto`. client_id:
required: false
description: The client ID that Home Assistant will use. Has to be unique on the server. Default is a randomly generated one.
type: string
keepalive:
required: false
description: The time in seconds between sending keep alive messages for this client. Default is 60.
type: int
username:
required: false
description: The username to use with your MQTT broker.
type: string
password:
required: false
description: The corresponding password for the username to use with your MQTT broker.
type: string
protocol:
required: false
description: Protocol to use: 3.1 or 3.1.1. By default it connects with 3.1.1 and falls back to 3.1 if server does not support 3.1.1.
type: string
certificate:
required: false
description: Path to the certificate file, eg. `/home/user/.homeassistant/server.crt`.
type: string
tls_insecure:
required: false
description: Set the verification of the server hostname in the server certificate.
type: boolean
tls_version:
required: false
description: TLS/SSL protocol version to use. Available options are: `auto`, `1.0`, `1.1`, `1.2`. Defaults to `auto`.
type: string
{% endconfiguration %}
<p class='note warning'> <p class='note warning'>
There is an issue with the Mosquitto package included in Ubuntu 14.04 LTS. Specify `protocol: 3.1` in your MQTT configuration to work around this issue. There is an issue with the Mosquitto package included in Ubuntu 14.04 LTS. Specify `protocol: 3.1` in your MQTT configuration to work around this issue.