[DOCKER] [RELEASE] Ariston Boiler Integration for Sonoff iHost (eWeLink CUBE) & MQTT Bridge

eWeLink CUBE
,
1

Hi everyone! :waving_hand:

I wanted to share a custom Docker add-on I created specifically for the Sonoff iHost / eWeLink CUBE ecosystem: Ariston2MQTT Bridge.

If you have an Ariston boiler connected via Ariston NET, this container bridges your boiler directly into your local smart home setup, creating a native virtual device tile on your iHost dashboard and exposing full MQTT telemetry & bi-directional control for

Node-RED and Home Assistant.

──────

### :glowing_star: What it does:

β€’ :house: Native eWeLink CUBE Integration: Automatically creates and keeps in sync an active virtual boiler card on your iHost screen.

β€’ :sparkles: Built-in WebUI Dashboard (http://ihost.local:8080): Responsive dark-mode dashboard with live sensors, diagnostics, language switcher, and interactive test controls.

β€’ :satellite_antenna: Full Telemetry over MQTT:

  β€’ Water pressure (bar) with color-coded safety badges                                                                                                                                                                                                          

  β€’ Room & Target temperatures (Zone 1)                                                                                                                                                                                                                          

  β€’ Domestic Hot Water (DHW) & Outdoor probe temps                                                                                                                                                                                                               

  β€’ Heating flow/return temperatures & Thermal Delta Ξ”T                                                                                                                                                                                                          

  β€’ Flame status & diagnostic error codes (with plain-text descriptions)                                                                                                                                                                                         

  β€’ Real-time energy consumption (Gas CH/DHW in kWh & mΒ³) and estimated monthly bill in your currency.

β€’ :video_game: Full Bi-Directional Control via MQTT / Node-RED:

  β€’ Boiler mode: summer, winter, off / standby                                                                                                                                                                                                                   

  β€’ Room mode: manual (permanent setpoint) vs time_program (scheduled profile)                                                                                                                                                                                   

  β€’ Target temperatures (Room & DHW)                                                                                                                                                                                                                             

  β€’ DHW Comfort preheating mode (disabled, time_based, always_active) β€” great for Node-RED night-time gas optimization!

β€’ :shield: Smart Cloud Rate-Limiting Protection: Built-in 20-second debounce batcher and 200-second cooldown protection against Ariston API rate limits (no HTTP 500 / 429 errors).

β€’ :floppy_disk: SD-Card & Flash Friendly: All diagnostic logs and state events run strictly in RAM (circular ring buffer) with zero continuous disk writes, ensuring your iHost SD card stays healthy.

──────

### :rocket: Quick Setup on Sonoff iHost:

1. In your iHost Web UI, go to Docker β†’ Image, search for:

tmalex/ariston2mqtt_ihost:latest (or :v2.4.0) and click Download.

2. Go to Containers β†’ Run Container:

  β€’ **Network Mode:** Select Host (essential for local MQTT & mDNS communication).                                                                                                                                                                                   

  β€’ **Volume:** Map /data to a persistent folder on your SD card.                                                                                                                                                                                                    

  β€’ **Port:** 8080:8080.

3. Open http://ihost.local:8080, enter your Ariston NET & MQTT credentials in the Settings popup, and click Save & Reconnect!

──────

Docker Hub Repository:

:backhand_index_pointing_right: tmalex/ariston2mqtt_ihost:latest

Feedback, questions, and feature requests are very welcome! Hope this helps fellow iHost users automate their heating more efficiently this winter. :fire::snowflake:

2

1. :chart_increasing: Interactive Telemetry History & Live Charts

β€’ Added real-time tracking for: Room Temp, Target Setpoint, Outdoor Temp, Flow & Return Temperatures, DHW (Hot Water), Water Pressure, and Flame burner status.
β€’ You can toggle any line directly from the legend (and the dashboard remembers your preferences).
β€’ Configurable retention from 24 hours up to 90 days.

2. :stethoscope: Smart Boiler Health & Leak Diagnostics

Instead of waiting for an error to pop up on the boiler screen, the bridge now analyzes telemetry trends:

β€’ Slow Leak Detection: Watches cold/resting pressure over 7–14 days and warns you if there’s a slow pressure drop before error 108 (Low Water Pressure) shuts down heating.
β€’ Expansion Vessel Fault Warning: Detects abnormal pressure spikes when the boiler heats up (identifying a deflated air cushion or ruptured membrane).
β€’ Winter Condensation Efficiency Score: Measures how much time your return temperature stays below 53Β°C for optimal condensing efficiency.

3. :robot: Native Model Context Protocol (MCP) Server for AI

If you use AI agents or local assistants like Hermes, OpenClaw, Claude Desktop, or LibreChat, the bridge now includes a built-in MCP server:

β€’ Endpoint ex: http://ihost.local:8080/mcp/sse (or /mcp)
β€’ Exposed Tools:
β€’ get_boiler_telemetry() β€” live readings & status
β€’ get_boiler_history(hours) β€” historical curves
β€’ get_health_diagnostics() β€” instant leak & expansion vessel report
β€’ set_room_temperature(), set_boiler_mode(), set_dhw_temperature()

4. :shield: Multi-language

β€’ Multi-language WebUI support (English, Romanian, Italian, German, Spanish, French).

:rocket: Quick Run on iHost:

β€’ Image: tmalex/ariston2mqtt_ihost:latest (or :v2.4.0 / :armv7)

β€’ Network: Host mode
β€’ Mount: /data (Host path on iHost SD card)
β€’ WebUI: http://ihost.local:8080 (or your iHost IP)