iQua Softener for Home Assistant (Marketplace integration)

Installs: 229 sharing analytics
GitHub stars: 11
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: 2.4.0, October 1, 2026
Category: Water, Water treatment
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: iqua_softener
Source: github.com/mutilator/homeassistant-iqua-softener
Issues: Report an issue

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

About

iQua Softener is an integration that connects Home Assistant to water softeners supported by the iQua app. It relies on the vendor's cloud and is set up in the UI, where a legacy iQua or newer iQua2 API type is chosen along with a polling interval and a real-time updates option. It adds sensors for salt level, estimated out-of-salt day, last regeneration, available water, current flow, daily water usage and WiFi signal strength. A switch opens and closes the water shutoff valve remotely, and a button starts a regeneration cycle. Select entities change settings such as salt type, inlet water hardness, regeneration time, efficiency mode and the maximum days between recharges. Water flow can update over a WebSocket connection, which the integration reconnects on a short interval because the API stops sending flow data after a few minutes, while other sensors follow the polling interval.

Automatic summary of the README and code of mutilator/homeassistant-iqua-softener. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

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

Setup

API TypeSelect which API to use: iQua for legacy devices or iQua2 for newer devices
Username
Password
Update Interval (minutes)
Enable Real-time Updates

Select Device

Device

After setup

Update Interval (minutes)
Enable Real-time Updates

Texts from the code of mutilator/homeassistant-iqua-softener.

Entities

SelectsSalt Type, Inlet Water Hardness, Regeneration Time, Efficiency Mode, Max Days Between Recharges, 97% Feature
SensorsState, Date/Time, Last Regeneration, Out of Salt Estimated Day, Salt Level, Available Water, Water Current Flow, Today Water Usage, Water Usage Daily Average, Water Shutoff Valve State, WiFi Signal Strength, Water Hardness
SwitchesWater Shutoff Valve

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:iQua Softener: entity IDs renamed

From the README

iqua_softener is a custom component for Home Assistant. The integration allows you to pull data for you iQua app supported water softener from Ecowater company server.
🔄 Real-time Updates: WebSocket support for instant water flow monitoring
💧 Water Control: Remote water shutoff valve control for emergency situations
📊 Comprehensive Monitoring: 11 sensors covering all aspects of your water softener
⚙️ Configurable: Adjustable polling intervals and real-time update settings
⚡ Device Control: Button entity for starting regeneration cycles on demand
🏠 Native Integration: Full Home Assistant integration with device grouping
🔧 Automation Ready: Perfect for leak detection and water usage automations

From the README of mutilator/homeassistant-iqua-softener, MIT License. Shortened.