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

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_integration_type
MQTT Eventstream	Instructions on how to setup MQTT eventstream within Home Assistant.	Other	0.11	Local Polling	mqtt_eventstream	integration

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: List of events which will not be sent over mqtt. required: false type: list {% endconfiguration %}

Multiple Instances

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

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

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

# Example child instance configuration.yaml entry
mqtt_eventstream:
  publish_topic: child/upstairs
  subscribe_topic: parent/topic

# Example child instance configuration.yaml entry
mqtt_eventstream:
  publish_topic: child/downstairs
  subscribe_topic: parent/topic