Luxtronik for Home Assistant (Marketplace integration)

Installs: 687 sharing analytics
GitHub stars: 173
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 2026.10.18, October 23, 2026
Category: Climate, Heat pumps and air conditioning
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: luxtronik2
Source: github.com/BenPru/luxtronik
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Luxtronik is an integration that monitors and controls heat pumps with a Luxtronik controller over the local network. It works without internet access and is added through the UI, where the host, port, timeout and data package length can be set; Home Assistant can also find the heat pump on the network. It adds sensors, binary sensors, numbers, selects, switches, text fields, dates, a firmware update, a water heater and heating and cooling climate entities. Timer schedules for hot water, heating, ventilation and the circulation pump can be edited, along with away mode dates and hot water blocking times. Options allow an indoor temperature sensor for the heating thermostat and an external power sensor for the COP calculations. It builds on the Bouni integration, adds predefined entities and a full UI setup, and can run alongside it.

Automatic summary of the README and code of BenPru/luxtronik. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Climate
Water heaters
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Luxtronik Heatpump Setup

HostHostname or IP address
Network PortNormally 8889 or 8888
Network socket timeout (Sec.)If the network or the heatpump is slow, you can fine-tune the timeout.
Max data package lengthIf the network or the heatpump is slow, you can fine-tune the data package length.

Also asked when changing the connection.

Select Devices to Configure

Select the device you want to configure

After setup

Sensor ID for the indoor temperatureA thermostat for heating control is created in Home Assistant. The actual temperature for this is set by a Home Assistant sensor. If Luxtronik is connected to a hardware room thermostat, then this field should be left empty.
Sensor ID for the current power consumptionIf the heat pump's built-in current power consumption reading is inaccurate, an external Home Assistant power sensor (e.g. a smart plug) can be used instead for the Heating/DHW COP calculations. This does not change what the Current power consumption sensor itself displays. Leave empty to use the heat pump's built-in reading.
Update intervalHow often to poll the heat pump for new data.
Set the room target in Home Assistant (RBE)The Heating thermostat's target becomes a room temperature. Home Assistant adjusts the heating curve correction (Temperature +/-) so the heat pump behaves as if the RBE dial were set to that target. The target can be at most 5 K divided by the room temperature impact factor away from the RBE dial. The RBE's own setback schedule is overridden. The heat pump regulates on the RBE's own room reading: an indoor temperature sensor selected above is only displayed on the card and is not used for this.

Texts from the code of BenPru/luxtronik.

Entities

Binary sensorsLocktime, EVU2, Compressor, Compressor 2, Pump flow, Compressor heater, Defrost valve, Additional heat generator, Additional heat generator 2, and 10 more
ClimateHeating, Cooling
DatesAway Mode DHW Start Date, Away Mode DHW End Date, Away Mode Heating Start Date, Away Mode Heating End Date
NumbersRelease second heat generator, Release time second heat generator, Pump optimization, Circulation pump run time per cycle, Circulation pump pause per cycle, Power limit, Thermal power limit: Heating, Thermal power limit: Water, Thermal power limit: Cooling, and 47 more
SelectsThermal Desinfection Day, Heating circuit control mode, Hot water timer program, Heating timer program, Ventilation timer program, Circulation pump timer program, PV Mode, Heating mode, DHW mode, and 5 more
SensorsStatus, SmartGrid Status, Last error, Switchoff reason, Status 1, Status 2, Status 3, To heat source, Heat source input, and 73 more
SwitchesEVU2 input (manual), Remote maintenance, Power limitation, Max. thermal power, Efficiency pump, Pump heat control, Heatingmode automatic, Pump optimization, and 6 more
TextsDHW Blocking Times (Week), DHW Blocking Times (Weekdays), DHW Blocking Times (Weekend), DHW Blocking Times (Monday), DHW Blocking Times (Tuesday), DHW Blocking Times (Wednesday), DHW Blocking Times (Thursday), DHW Blocking Times (Friday), and 42 more
UpdatesFirmware
Water heatersDomestic water

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Luxtronik integration is read-only (faulty firmware), Cannot connect to Luxtronik heat pump

From the README

This is a Home Assistant integration for Luxtronik heat pumps.
It is based on Bouni/luxtronik which provides the groundwork for this integration. This integration extends the Bouni integration with with predefined entities and a full UI setup. Bouni en BenPru can run side by side.

From the README of BenPru/luxtronik, MIT License. Shortened.