Monitor your SAUR water consumption directly in Home Assistant — daily, weekly, monthly and yearly usage, with Energy Dashboard integration.
Status: Beta — works in production, field-tested with a single meter installation. DE/ES translations were machine-authored and welcome native-speaker corrections.
- 7 sensor entities per meter subscription:
| Entity | Unit | Description |
|---|---|---|
| Water index | m³ | Absolute meter reading (feeds Energy Dashboard → Water) |
| Last reading date | date | Date of the latest SAUR reading |
| Daily consumption | L | Yesterday's usage |
| Weekly consumption | m³ | Current week total |
| Monthly consumption | m³ | Current month total |
| Yearly consumption | m³ | Current year total |
| Data age (diagnostic) | h | Hours since last API poll |
- Energy Dashboard compatible — add
Water indexto Settings → Energy → Water - Re-authentication flow — seamless credential update without removing the integration
- Repair Issues — HA alerts when data becomes stale (configurable threshold)
- Options flow — configure polling interval and stale-data threshold at runtime
- Multi-account — add multiple config entries for multiple subscriptions
- Localised — English, French, German, Spanish
- Home Assistant 2024.12.0 or later
- A SAUR customer portal account (email + password)
- Your meter must be enrolled in SAUR's remote-reading programme (most French meters since 2022)
- Open HACS in Home Assistant
- Click ⋮ → Custom repositories
- Add
https://github.com/netnic0/ha-sauronwith category Integration - Search for SAURon and click Download
- Restart Home Assistant
- Copy the
custom_components/sauron/folder to yourconfig/custom_components/directory - Restart Home Assistant
- Go to Settings → Integrations → + Add Integration
- Search for SAURon
- Enter your SAUR portal credentials (same as mon-espace.saurclient.fr)
- The integration auto-discovers your subscription ID — no manual entry needed
After setup, click Configure on the integration card to adjust:
| Option | Default | Description |
|---|---|---|
| Polling interval | 4 h | How often to query the SAUR API |
| Stale data threshold | 36 h | Hours before a Repair Issue is raised |
SAUR updates meter data once per day (J−1). Polling more often than every 4 hours is not useful.
Add the Water index sensor to the HA Energy Dashboard:
- Go to Settings → Energy
- Under Water, click Add water source
- Select
sensor.saur_water_meter_water_index - Save
HA will automatically track cumulative water consumption over time.
For daily/weekly/monthly resets independent of the SAUR API:
# configuration.yaml
utility_meter:
water_daily:
source: sensor.saur_water_meter_water_index
cycle: daily
water_monthly:
source: sensor.saur_water_meter_water_index
cycle: monthlySAUR transmits meter readings once per day, typically between midnight and 6 AM.
The Daily consumption sensor will show Unknown until the reading for J−1 arrives.
This is expected behaviour — not a bug.
"Invalid credentials" during setup
- Double-check your email and password on mon-espace.saurclient.fr
- SAUR accounts with two-factor authentication are not yet supported
"Cannot connect"
- The SAUR API (
apib2c.azure.saurclient.fr) may be temporarily unavailable - Check your internet connection and retry
Sensors show "Unknown" after install
- SAUR data updates once per day — wait up to 24 hours for the first readings
- Check the HA logs for debug output: enable
custom_components.sauron: debugin yourlogger:config
Stale data alert in Repairs
- Your meter may not be transmitting (check the SAUR portal)
- The threshold is configurable via Configure on the integration card
- The SAUR mobile API accepts
captchaToken: "true"as a literal string — no browser automation or real reCAPTCHA solving is required - No external Python library dependency — uses HA's bundled
aiohttp - All credentials are stored in HA's config entry and never sent to third parties
MIT — © 2026 Nicolas Diguet