HeatNexus – Windhager heating systems, fully local

I have been running my Windhager wood-chip boiler through Home Assistant for a
while and turned it into a proper integration. It talks to the controller’s own
HTTP API on the local network — no cloud, no account, no polling a vendor
server.

Repository: GitHub - xIceTea/HeatNexus: Home Assistant integration for Windhager heating systems - local polling over the InfoWIN Touch HTTP API, no cloud. PuroWIN, BioWIN, Infinity PLUS: boiler, heating circuits, buffer tank, DHW, solar. German user interface. · GitHub

What it does

  • Discovers the whole plant by itself. Boiler, heating circuits, buffer
    tanks, hot water, circulation, pump/relay modules. Datapoints your system does
    not have are dropped; write-protected ones are created read-only.
  • Ranges come from the device, not from a table I made up: minimum, maximum,
    step, unit and the permitted enum values are read from the controller’s own
    metadata.
  • A thermostat per heating circuit, with operating mode, comfort correction
    and a timed comfort setpoint — the same timed override the Windhager app
    writes.
  • Time programs for heating, hot water and circulation, readable and
    writable, with a weekly grid and an editor.
  • Faults in plain text — 217 fault texts with code, class and what to do.
  • Its own panel in the sidebar: a plant diagram generated from the parts
    that were actually discovered, live values on top, plus tabs for controls,
    maintenance, history and time programs.
  • A dashboard and six automation blueprints that build themselves from
    whatever your system reports.
  • Several systems in parallel — I run two.

Animated plant diagram

The diagram is assembled from the discovered parts — two buffer tanks give you
two. Pumps spin, flow and return show direction, tanks take the colour of their
sensors.

A note on language

The integration speaks German. Entity names, help texts and the bundled
dashboard use the same wording as the InfoWIN Touch control panel, so what you
read in Home Assistant matches what you read on the boiler. The README is
available in English so you can decide whether it fits before installing.

Hardware

Verified against real hardware: PuroWIN (wood chips), UML/UMLZ heating
circuit module, B-PLMi buffer charging module, ZSP pump/relay module.

Supported but unverified — the device database describes them and discovery
picks them up, I simply have no such system to measure against: BioWIN and
BioWIN 2 (pellets), heat pump, electric heater, gas and oil boilers, solar,
cascade, Infinity PLUS.

If you own one of those, I would like to hear from you. The integration has
a diagnostics export that is anonymised (serial numbers and IP addresses are
replaced) — that file is all I need to extend the coverage properly instead of
guessing from the manufacturer’s parameter file.

Requirements

Home Assistant 2025.6 or newer, and the IP address plus web password of your
controller. Install through HACS as a custom repository.

Licensed GPL-3.0.