Erik Montnemery bf12a9c3bf Update mqtt configuration example to use external broker (#9316)
* Update mqtt.markdown

* Update source/_docs/mqtt.markdown

Co-Authored-By: emontnemery <erik@montnemery.com>
2019-05-10 22:44:47 +02:00

35 lines
1.1 KiB
Markdown

---
layout: page
title: "MQTT"
description: "Details about the MQTT support of Home Assistant."
date: 2017-02-15 08:00
sidebar: true
comments: false
sharing: true
footer: true
---
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.
To integrate MQTT into Home Assistant, add the following section to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
mqtt:
broker: IP_ADDRESS
```
For detailed setup instructions, please refer to the [MQTT broker](/docs/mqtt/broker) documentation.
## {% linkable_title Additional features %}
- [Certificate](/docs/mqtt/certificate/)
- [Discovery](/docs/mqtt/discovery/)
- [Publish service](/docs/mqtt/service/)
- [Birth and last will messages](/docs/mqtt/birth_will/)
- [Testing your setup](/docs/mqtt/testing/)
- [Logging](/docs/mqtt/logging/)
- [Processing JSON](/docs/mqtt/processing_json/)
See the [MQTT example component](/cookbook/python_component_mqtt_basic/) how to integrate your own component.