ZoneFlow

Getting started

Want to see ZoneFlow first? Try the live demo in your browser, with no installation. How to use the demo shows what to try.

Prefer not to click through every screen yourself? Set up with an AI assistant first — paste one file into Claude, ChatGPT or another assistant, answer its questions about your garden, and let it configure your zones and run a test pulse for you. The steps below are for doing it by hand.

Install

Via HACS (recommended):

  1. In HACS, search for ZoneFlow Irrigation and click Download.
  2. Restart Home Assistant.

Manual install: copy custom_components/zoneflow/ into /config/custom_components/ and restart Home Assistant.

Add a zone

Go to Settings, Devices and Services, Add Integration, ZoneFlow Irrigation.

For an outdoor zone the first screen has a Quick setup box, ticked. After the name, plant and place it asks only for the valve, how the water is delivered, and how much water the zone gives: the number of emitters, the flow of one and the area they wet. The sensors ZoneFlow clearly found are used, and the plant type and a default climate give the rest. A rough flow figure is fine, because the Calibrate the flow rate button on the zone card measures it exactly later. Everything can be changed afterwards under Configure.

The first screen also has an optional Look up your plant list. Start typing, pick your plant, and its usual weekly amount of water becomes the zone's starting weekly targets. Leave it empty and nothing changes. See Watering tips.

Untick the box for the full setup, which has four short screens:

  1. Zone name and what's planted. The name becomes the device name and the default CSV file name. A plant preset — Tomatoes, Chilis, Leafy vegetables, Herbs, Strawberries, Flower bed, Lawn, Shrubs, Young tree, Fruit tree, or your own — pre-fills the weekly targets, crop factor, deep soak and growth ramp; every value stays adjustable afterwards.
  2. Entities and schedule. The valve, any optional sensors, the Shared pump ID if the pump is shared, units, soil and site description, growth ramp, CSV path, deep soak on or off, and both schedules.
  3. Climate. Your choice pre-fills the next screen.
  4. Temperature thresholds. Hot, cool and fallback temperature, in the zone's units.

Growing in a greenhouse or indoors? Pick Greenhouse or Indoor under Where it grows. ZoneFlow then also asks for your inside sensors and climate devices (fans, vents, misters, a heater), and the valve becomes optional. See Greenhouse and indoor zones.

The screens list the rain gauges, thermometers, weather entities, phones and valves Home Assistant already knows, with their names and current values, and fill in a clear single match. Questions you can't answer yet, such as the soil type, can be skipped.

If you have several parts of the garden, make an area for each, so the zones in it share a rain gauge, thermometer, forecast and phone. Adding a zone then asks which area it is in. You can also start a new zone from a copy of another zone or a saved preset. See Areas, plants and presets.

The last step of adding a zone with a valve is an optional valve test: the valve opens for about 2 seconds and ZoneFlow says whether it answered and closed again.

The zone card's Settings opens with the everyday settings; Show all settings shows the rest. Every setting has a ? that opens the page explaining it.

Add further zones the same way. Sensors can be added or removed later under Configure.

Before you leave it running

  1. Set the emitter flow rate. This is the one number that must be right. The easy way is the Calibrate the flow rate button on the zone card: run the valve for 15 minutes, catch the water in a bucket or read it from a meter, and enter the litres and the area. The same step also sets the zone's litres per minute, so the zone card can show how many litres each watering used. See Calibration, How to measure your irrigation flow rate with a bucket and Service runs.
  2. Seed the history dates (Last Routine, Last Deep Soak) if the plant already has a watering history, so it is not treated as overdue. See Health journal and history.
  3. Press Service Run 1 min to confirm that the valve, pump and log all work, then press Check my setup on the zone card for a plain checklist of anything still missing.
  4. Add the dashboard card. See Dashboard cards.

Replacing an existing YAML setup?

Follow the safe cutover steps.