jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Site updated at 2017-05-30 15:55:51 UTC

Browse source
This commit is contained in:
Travis CI 2017-05-30 15:55:51 +00:00
parent 72c178b60d
commit 86fe6ee024
25 changed files with 44 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

7
docs/mqtt/broker/index.html
View file

@ -129,7 +129,9 @@ This broker does not currently work with OwnTracks because of a protocol version
<span class="s">keepalive</span><span class="pi">:</span> <span class="s">60</span>
<span class="s">username</span><span class="pi">:</span> <span class="s">USERNAME</span>
<span class="s">password</span><span class="pi">:</span> <span class="s">PASSWORD</span>
<span class="s">protocol</span><span class="pi">:</span> <span class="s">3.1</span>
<span class="s">protocol</span><span class="pi">:</span> <span class="s">3.1</span>
<span class="s">tls_insecure</span><span class="pi">:</span> <span class="s">True</span>
<span class="s">tls_version</span><span class="pi">:</span> <span class="s">1.2</span>
</code></pre>
</div>
<p>Configuration variables:</p>
@ -141,9 +143,12 @@ This broker does not currently work with OwnTracks because of a protocol version
<li><strong>username</strong> (<em>Optional</em>): The username to use with your MQTT broker.</li>
<li><strong>password</strong> (<em>Optional</em>): The corresponding password for the username to use with your MQTT broker.</li>
<li><strong>protocol</strong> (<em>Optional</em>): 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.</li>
<li><strong>tls_insecure</strong> (<em>Optional</em>): Set the verification of the server hostname in the server certificate.</li>
<li><strong>tls_version</strong> (<em>Optional</em>): TLS/SSL protocol version to use. Available options are: <code class="highlighter-rouge">auto</code>, <code class="highlighter-rouge">1.0</code>, <code class="highlighter-rouge">1.1</code>, <code class="highlighter-rouge">1.2</code>. Defaults to <code class="highlighter-rouge">auto</code>.</li>
</ul>
<p class="note warning">
There is an issue with the Mosquitto package included in Ubuntu 14.04 LTS. Specify <code class="highlighter-rouge">protocol: 3.1</code> in your MQTT configuration to work around this issue.
If you get this error <code class="highlighter-rouge">AttributeError: module 'ssl' has no attribute 'PROTOCOL_TLS'</code> then you need to set <code class="highlighter-rouge">tls_version: 1.2</code>.
</p>
<p class="note">
If you are running a mosquitto instance on a different server with proper SSL encryption using a service like letsencrypt you may have to set the certificate to the operating systems own <code class="highlighter-rouge">.crt</code> certificates file. In the instance of ubuntu this would be <code class="highlighter-rouge">certificate: /etc/ssl/certs/ca-certificates.crt</code>