home-assistant.io/source/_components/mqtt_eventstream.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	MQTT Eventstream	Instructions how to setup MQTT eventstream within Home Assistant.	2016-01-13 08:00	true	false	true	true	mqtt.png	Other	0.11	depends

The mqtt_eventstream component connects two Home Assistant instances via MQTT.

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 {% endconfiguration %}

{% linkable_title 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/#

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