ebusd Vaillant

Home Assistant custom component for Vaillant heating and hot water systems controlled over ebusd via MQTT.

Read the full documentation.

Features

• Auto-discovery - no manual entity configuration; entities appear as ebusd publishes topics
• Heating zones (Z1-Z4) - HVAC mode, temperature control, holiday schedules, quick veto (boost)
• Hot water (HWC) - operation mode, target/current temperature
• Water pressure sensor - live pressure reading in bar
• Preset modes - Boost (quick veto) and Away (holiday period)

Requirements

• eBUS hardware adapter, such as the C6 stick
• An ebusd instance publishing Vaillant messages to MQTT, see ebus setup
• Home Assistant with the MQTT integration configured

Installation (HACS)

1. Go to HACS → Custom repositories (HACS custom repositories docs)
2. Add the repository URL: https://github.com/signalkraft/ebusd-vaillant-component with category Integration and save
3. Search for the ebusd Vaillant integration in HACS and download it
4. Restart Home Assistant
5. Add the integration through Settings → Devices & services → Add integration → ebusd Vaillant (or click here)
6. Configure the MQTT topic prefix (default: ebusd) and display name

Installation (manual)

1. Download the latest ebusd_vaillant.zip from the releases page
2. Unzip into your Home Assistant custom_components directory so the path becomes custom_components/ebusd_vaillant/
3. Restart Home Assistant
4. Add the integration through Settings → Devices & services → Add integration → ebusd Vaillant (or click here)
5. Configure the MQTT topic prefix (default: ebusd) and display name

Note: Entities are discovered as ebusd publishes their topics. After adding the integration, it can take a few minutes for all entities to appear in Home Assistant.

Configuration

Setting	Default	Description
MQTT prefix	ebusd	Root topic ebusd publishes to
Name	Vaillant	Label prefix for entity names

Services

The integration exposes two diagnostic services:

• ebusd_vaillant.dump_mqtt_values - returns all accumulated MQTT values as YAML
• ebusd_vaillant.record_topic_changes - listens for timeout seconds and returns received topic values

MQTT Mapping

See the MQTT Mapping page for the complete reference of which topics map to which Home Assistant controls.

Troubleshooting

Check the ebus setup & troubleshooting guide.