Water your garden by what the soil actually needs — not by a fixed timer. Soil Smart Irrigation is a Home Assistant integration that decides if, when and how much to water each zone, driven by a soil moisture sensor, an evapotranspiration (ET) estimate, or both — and dosed by volume (liters) for drip and emitter systems, not just minutes.
Most Home Assistant irrigation tools either schedule watering (you decide the amount) or estimate soil dryness from the weather (evapotranspiration) and can't read a soil probe at all. If you have a moisture sensor, or you water a hedge or trees with drippers, neither fits well.
Soil Smart Irrigation fills that gap:
- Measure, don't just guess. Point it at a soil moisture sensor and it waters when the ground is genuinely dry.
- No sensor? Use ET. A weather-based water-balance "bucket" keeps working for plants without a probe.
- Dose in liters, not just minutes. Give it your emitter flow and it works out the run time to deliver the water each plant needs — the natural unit for drip and micro-irrigation.
- Per-zone setup — add one zone per plant group (lawn, hedge, trees, berries, beds).
- Plant-type presets so you don't need to know a crop coefficient from a hole in the ground.
- Three modes: soil sensor, evapotranspiration, or hybrid.
- Automatic ET₀ from Open-Meteo (free, no API key, uses your Home Assistant location) — or plug in your own ET₀ sensor.
- Volume (litres per plant) or depth (mm) dosing, converted to a run time from your zone flow.
- Rainfall-aware — skips after real rain, and counts only effective rain in the water balance (a per-zone effectiveness factor plus daily interception), so mulched, deep-rooted or drip zones aren't fooled by light showers that only wet the surface.
- Minimum interval between waterings, so roots grow deep.
- Simple outputs you wire to any valve or switch — works with any hardware.
Click the badge to add the repository to HACS, or add it manually:
- In HACS, open the menu → Custom repositories.
- Add
https://github.com/makstech/soil-smart-irrigationwith category Integration. - Search for Soil Smart Irrigation, download, and restart Home Assistant.
- Go to Settings → Devices & Services → Add Integration → Soil Smart Irrigation and add a zone.
Each zone is one entry. The fields you'll see depend on the mode:
| Field | Meaning |
|---|---|
| Mode | sensor, et, or hybrid |
| Soil moisture sensor | The probe for this zone (sensor / hybrid) |
| Water below / target moisture | Trigger and target moisture (%) |
| Reference ET₀ sensor + Kc | Daily ET₀ (mm) and crop coefficient (et / hybrid) |
| Dosing | volume (liters) or depth (mm over an area) |
| Water per run | Liters, or mm + area |
| Total zone flow | Combined emitter/nozzle flow in L/min |
| Recent rainfall sensor | e.g. a 7-day rainfall total |
| Minimum days between watering | Keep watering deep and infrequent |
For each zone:
binary_sensor.<zone>_irrigation_needed— whether to water now.sensor.<zone>_recommended_duration— how long to run (minutes).sensor.<zone>_required_water— how much to deliver (liters).sensor.<zone>_soil_deficit— the ET water-balance deficit (mm).- Buttons to mark a zone watered or reset its deficit.
You wire these to your valves with a small automation, so it works with any controller — a Shelly, an ESPHome board, a Zigbee valve, anything.
- Sensor mode waters when the moisture reading falls to your low threshold.
- ET mode keeps a per-zone water balance: it accrues crop water use (ET₀ × Kc) and subtracts effective rainfall —
max(0, daily rain − interception) × effectiveness— so rain that runs off mulch or never reaches deep roots doesn't wipe the deficit; when the deficit reaches your trigger, it's time to water. - Hybrid trusts the probe when it's reporting and falls back to the ET estimate otherwise.
A minimum interval and a rainfall skip keep watering deep and infrequent, which is better for roots than a daily sprinkle.
In ET or Hybrid mode the default ET₀ source is Automatic: once an hour the integration fetches the hourly reference-evapotranspiration series from the free Open-Meteo API, using your Home Assistant location, and accrues the deficit hour by hour — so hot, sunny afternoons push it up faster than cool nights. No API key, no account, and no weather integration required.
- What's sent: only your latitude and longitude.
- What comes back: the finished FAO-56 Penman-Monteith ET₀, resolved hourly. All the meteorology — temperature, humidity, wind (standardised to 2 m), solar radiation — is computed on Open-Meteo's side, so there's nothing to wire up and no unit or wind-height gotchas.
- Offline: the fetched series runs a couple of days ahead, so short outages keep advancing the deficit; after a restart it recovers recent missed hours within that ~2-day window.
- Prefer not to reach out? Set the ET₀ source (under Advanced) to Use an ET₀ sensor and feed your own value; the integration then makes no external calls.
- Use a soil sensor to auto-calibrate the ET estimate (hybrid mode).
- Soak-and-cycle splitting to avoid runoff on sprinkler zones.
- Optional weather-entity ET₀ source (offline, or your own provider).
- Tests and more translations.
- esphome-irrigation-system — the DIY ESP32 valve/pump controller this was built alongside.
Issues and pull requests are welcome. This is a young project — real-world zones, plant types, and sensors are exactly what it needs.
MIT — see LICENSE.
