Hargassner Pellet Boiler Integration - Real-time monitoring via Telnet
I’m excited to share my Hargassner Pellet Boiler Integration for Home Assistant! This integration provides real-time monitoring of your Hargassner pellet boiler through a direct telnet connection - no cloud dependency needed.
Key Features
- Real-time monitoring of up to 228 boiler parameters via direct telnet connection
Energy Dashboard integration with automatic kWh calculation based on pellet consumption
Flexible sensor sets: Choose between Standard (17 essential sensors) or Full (228 sensors)
Automatic reconnection with intelligent retry logic
Bilingual support (English/German) for sensor names and states
Robust & thread-safe async telnet client with proper error handling
100% local - no cloud services required
Screenshots
Device Overview:
Custom Dashboard with Pellet Consumption Forecast:
Energy Dashboard Integration:
Installation via HACS
- Open HACS in Home Assistant
- Go to Integrations
- Click the ⋮ menu → Custom repositories
- Add repository:
- URL:
https://github.com/bauer-group/IP-HargassnerIntegration - Category: Integration
- URL:
- Click Install and restart Home Assistant
Quick Configuration
After installation:
- Go to Settings → Devices & Services → Add Integration
- Search for “Bauergroup Hargassner”
- Enter your configuration:
- Host: IP address of your boiler (e.g.,
192.168.1.100) - Firmware: Select your firmware version (currently
V14_1HAR_q1fully tested) - Device Name: Choose a friendly name
- Language: EN or DE
- Sensor Set: STANDARD (17 sensors) or FULL (228 sensors)
- Pellet Energy & Efficiency: For accurate energy calculations (defaults: 4.8 kWh/kg, 90%)
- Host: IP address of your boiler (e.g.,
Available Sensors
STANDARD Set (17 Sensors)
Perfect for most users, includes:
- Connection status & Boiler state
- Core temperatures (Boiler, Flue Gas, Buffer zones, Hot Water, Return)
- Output power (%)
- Pellet stock & consumption
- Heat Output (kWh) - automatically calculated for Energy Dashboard
- Buffer fill level
FULL Set (228 Sensors)
For advanced diagnostics:
- All temperatures (HC 1-8, Solar, DHW)
- All motors & pumps (M1-M38)
- All digital inputs (E1-E16)
- Heating circuit modes, valve positions, motor currents
- Complete system diagnostics
Energy Dashboard Integration
The integration automatically creates a Heat Output sensor compatible with Home Assistant’s Energy Dashboard. The calculation uses:
Heat (kWh) = Pellets (kg) × Energy Content (kWh/kg) × Efficiency (%)
Both values are fully customizable in the integration options!
Supported Models
| Model | Firmware | Status |
|---|---|---|
| Nano-PK | V14_1HAR_q1 |  Fully tested |
| Other models | Custom |  Requires firmware template |
Additional firmware versions can be easily added via XML templates. See the documentation for details.
Resources
- GitHub Repository: GitHub - bauer-group/IP-HargassnerIntegration: Home Assistant integration for Hargassner pellet boilers without cloud / Home Assistant-Integration für Hargassner-Pelletkessel ohne Cloud
- Documentation: Detailed guides for installation, custom dashboards, and adding firmware support
- Issue Tracker: GitHub · Where software is built
Feedback Welcome
This is my first Home Assistant integration, and I’d love to hear your feedback! If you have a Hargassner boiler with a different firmware version, please reach out - I can help you add support for it.
License: MIT
IoT Class: Local Polling
Quality Scale: Silver