ZoneFlow Irrigation
ZoneFlow turns Home Assistant into the irrigation controller. Use the valves, pumps, sensors and weather hardware you already have — from simple Zigbee relays to more advanced flow and soil sensors.
Full documentation: zoneflowirrigation.com
Try it first: live demo with a guided tour. A simulated garden you can click through in your browser, no install needed.
If your garden is happier with ZoneFlow, give the project a ⭐ so other gardeners can find it too.
ZoneFlow works out when and how much each part of your garden needs water, from the plant, the soil, the weather and the rain, then runs the valve and tells you in plain words what it did and why. It also controls the climate of a greenhouse or indoor grow space. Only a valve switch is required; every sensor is optional and each one adds a capability.
What it can do
- Waters by need. A light routine watering and an occasional deep soak per zone, from temperature tiers or an evapotranspiration curve, adjusted for the plant, soil, slope and mulch.
- Uses the rain. Rain credit from a rain gauge or a weather station (Ecowitt, Ambient Weather, Tempest, Davis and others), rain you enter by hand, a pause after heavy rain, a forecast skip and a frost guard.
- Says why. A plain-language status for every zone ("Skipped: the soil is wet (72%)"), phone notifications and a weekly summary.
- Greenhouse and indoor zones. Fans, vents, misters and a heater from an inside sensor, with several crops under one greenhouse.
- Areas and plants. Group zones into the parts of your garden (Backyard, Front yard) that share a rain gauge, thermometer and phone, pause a whole area at once, and keep a history for each plant. Copy a bed's settings to a new one or save them as a preset.
- Easy setup. A "Check my setup" checklist, a guided flow-rate calibration, likely sensors suggested in setup, a Simple view, buttons on phone messages and fix buttons in Repairs.
- Water use. Litres and gallons per watering, for the last 30 days and for the year.
- Safe by design. Runtime caps, a stuck-valve watchdog, pump and flow checks and power-loss handling: a cycle always ends with the valve closed.
- Easy to run. Built-in dashboard cards and a ready-made dashboard, 19 languages, no YAML, and an optional AI-assisted setup.
See it
Or try it yourself in the live demo.
Install
One click:
Or by hand:
- In HACS, search for ZoneFlow Irrigation and click Download. ZoneFlow is in the HACS default list, so no custom repository is needed.
- Restart Home Assistant.
- Settings → Devices & services → Add integration → ZoneFlow Irrigation, and follow the screens.
If HACS does not list it yet (its list refreshes now and then), add it by hand first: HACS → ⋮ → Custom repositories → https://github.com/Dreamer41/ha-smart-irrigation, type Integration.
Requires Home Assistant 2024.5 or newer. To install without HACS, copy custom_components/zoneflow/ into /config/custom_components/ and restart.
First steps for a new zone: set the flow rate (the one number that must be right), press Service Run 1 min to check the valve, then let it run.
Documentation
Help and feedback
Questions and bug reports: GitHub issues.
Credits
The plant lookup (Watering tips on the zone card, and when you add a zone) suggests:
- weekly amounts of water from the
Plant Variety Database by
Wind River Greens, licensed
CC BY 4.0. Only the weekly
watering amounts were taken, converted from inches to millimetres;
- crop factors (Kc) from Allen, R. G., Pereira, L. S., Raes, D. and Smith, M. (1998),
Crop evapotranspiration: guidelines for computing crop water requirements,
FAO Irrigation and drainage paper 56, Table 12. The values were typed in from the table;
- crop factors for mango and guava from
UF/IFAS Extension AE456, for papaya from Posse et al. (2008),
and for basil from Rahimikhoob, Sohrabi and Delshad (2019);
- for plants with nothing of their own, estimates from the water-use classes of landscape plant factors
(WUCOLS, University of California), and weekly amounts worked out from the
crop factor. These are marked as estimates wherever they are shown.
License
MIT.
