home-assistant.io/source/_components/mqtt_eventstream.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

1.6 KiB

title, description, logo, ha_category, ha_release, ha_iot_class
title description logo ha_category ha_release ha_iot_class
MQTT Eventstream Instructions on how to setup MQTT eventstream within Home Assistant. mqtt.png
Other
0.11 Configurable

The mqtt_eventstream integration connects two Home Assistant instances via MQTT.

Configuration

To integrate MQTT Eventstream into Home Assistant, add the following section to your configuration.yaml file:

# Example configuration.yaml entry
mqtt_eventstream:
  publish_topic: MyServerName
  subscribe_topic: OtherHaServerName

{% configuration %} publish_topic: description: Topic for publishing local events. required: false type: string subscribe_topic: description: Topic to receive events from the remote server. required: false type: string ignore_event: description: Ignore sending these events over mqtt. required: false type: list {% endconfiguration %}

Multiple Instances

Events from multiple instances can be aggregated to a single master instance by subscribing to a wildcard topic from the master instance.

# Example master instance configuration.yaml entry
mqtt_eventstream:
  publish_topic: master/topic
  subscribe_topic: slaves/#
  ignore_event:
    - call_service
    - state_changed

For a multiple instance setup, each slave would publish to their own topic.

# Example slave instance configuration.yaml entry
mqtt_eventstream:
  publish_topic: slaves/upstairs
  subscribe_topic: master/topic
# Example slave instance configuration.yaml entry
mqtt_eventstream:
  publish_topic: slaves/downstairs
  subscribe_topic: master/topic