DHE Connect for Home Assistant (Unofficial)

Unofficial local Home Assistant integration for compatible DHE Connect instantaneous water heaters.

The integration uses the local DHE web interface only (no cloud relay).

Status

• Current version: 2.0.6
• Minimum supported Home Assistant version: 2026.6.0
• Release channel: stable
• Quality target: Home Assistant Quality Scale Platinum track for a custom integration
• Support scope: stable tags are supported; private/dev branches are best-effort
• Not an official Home Assistant Core certification

Highlights

• Local runtime connection (Socket.IO / Engine.IO), no cloud dependency.
• Climate target temperature control with reconnect-aware behavior.
• Live water flow and live power for daily monitoring.
• Timer, eco mode, child safety, bath fill and wellness controls.
• Radio and weather support through the DHE runtime payload.
• Multi-device support: one config entry per DHE.

Important Entities

Common entities used in dashboards and automations:

• climate.dhe_connect
• sensor.dhe_connect_connection_state
• sensor.dhe_connect_current_power
• sensor.dhe_connect_current_water_flow
• switch.dhe_connect_eco_mode
• switch.dhe_connect_bath_fill

Complete entity reference: docs/entities.md

Quick Automation Example

alias: DHE eco mode at night
triggers:
  - trigger: time
    at: "22:30:00"
actions:
  - action: switch.turn_on
    target:
      entity_id: switch.dhe_connect_eco_mode
mode: single

More automation examples and practical scenarios:

• docs/examples.md
• docs/use-cases.md

Installation

HACS custom repository

1. Open HACS.

2. Go to Integrations.

3. Open Custom repositories.

4. Add:

   https://github.com/memphi2/ha-dhe-connect
   

5. Category: Integration.

6. Install DHE Connect.

7. Restart Home Assistant.

8. Add from Settings -> Devices & services.

Manual installation

Copy to:

/config/custom_components/stiebel_dhe_connect/

Restart Home Assistant and add DHE Connect from the UI.

Removal

1. Open Settings -> Devices & services.
2. Open the DHE Connect integration entry.
3. Use the three-dot menu -> Delete.
4. For manual installs, remove /config/custom_components/stiebel_dhe_connect/ after the entry is removed.

Setup

The setup flow supports:

• Zeroconf discovery (_ste-dhe._tcp.local.)
• Subnet scan (private IPv4 ranges, default port 8443)
• Manual host/port entry

Zeroconf usually requires mDNS visibility in the local subnet/VLAN or an explicit relay setup across subnets.

Each DHE uses its own token file:

/config/.storage/stiebel_dhe_connect_token_<host>_<port>.txt

Security Notes

• Use only on trusted local networks.
• Do not expose the DHE web interface to the internet.
• Treat Home Assistant backups/config mounts as sensitive.
• Do not publish tokens, private hosts or private IPs.

See SECURITY.md.

Documentation

Topic	Document
Pairing, connectivity and recorder troubleshooting	docs/troubleshooting.md
Entity list, attributes and service examples	docs/entities.md
Automation examples	docs/examples.md
Practical use cases	docs/use-cases.md
Known limitations	docs/known_limitations.md
Device and firmware evidence matrix	docs/firmware_matrix.md
Protocol and ODB reference	docs/protocol.md
Migration policy (v2 line)	docs/migration_policy.md
Release process checklist	docs/release_process.md
German quick guide	docs/de.md
Legal and asset hygiene	docs/legal.md

Legal Notes

This repository is an independent community project.

• Unofficial integration: no affiliation with, endorsement by, or sponsorship from STIEBEL ELTRON, Home Assistant, Nabu Casa, or HACS.
• Trademark notice: names such as STIEBEL ELTRON, DHE Connect, Home Assistant, HACS, and Nabu Casa are used only for compatibility reference and belong to their respective owners.
• No official Home Assistant Core certification is claimed.

See docs/legal.md for full legal and asset-hygiene details.