Recipe and Batch Automation

Last updated March 27, 2026

Overview

Recipe automation lets you define multi-step sequences that control your actuators and setpoints automatically. Each recipe is a series of stages — for example, a beer brewing recipe might have Mash (60 min at 65C), Boil (90 min at 100C), Chill (until 20C), and Ferment (14 days at 18C).

Recipes are managed at /recipes and run from the dashboard.

Creating a Recipe

  1. Navigate to /recipes to open the Recipe Library.
  2. Click New Recipe.
  3. Enter a name and optional description.
  4. Add stages (see below).
  5. Click Save.

You can also duplicate an existing recipe to use it as a starting point.

Defining Stages

Each stage in a recipe has:

Name

A descriptive label like "Mash Rest" or "Cold Crash."

Duration

How long the stage runs. Set a value and unit (seconds, minutes, hours, or days). For example, 60 minutes for a mash step or 14 days for fermentation.

Setpoints

Target values for sensors in specific rooms. For example, set the Mash Tun temperature to 65C. When the stage starts, these setpoints are written to the device, and controllers (PID or hysteresis) work to reach and maintain them.

Actuator States

Explicit on/off commands for actuators. For example, turn the mixer on during the mash step and off during the boil.

Transition Condition

What triggers the move to the next stage:

  • Timer — Advance after the duration elapses (most common).
  • Sensor reached — Advance when a sensor value meets a condition (e.g., temperature below 20C). Useful for stages like "chill until cool enough."

Reordering Stages

Drag stages up or down to change their execution order. The recipe runs stages sequentially from top to bottom.

Running a Recipe

From the dashboard, open the Recipe Runner panel on your device:

  1. Select a recipe from your library.
  2. Click Start. The first stage begins immediately.
  3. The progress bar shows which stage is active and how much time remains.

Controls During Execution

  • Pause — Temporarily halts the recipe. Timers stop, setpoints hold at current values.
  • Resume — Continues from where you paused.
  • Abort — Stops the recipe entirely. Actuators return to their default states.

Recipe Library Management

  • Duplicate — Clone a recipe to create a variation without modifying the original.
  • Delete — Remove a recipe permanently.
  • Templates — Mark a recipe as a template to share it across devices (coming soon).

Example: Basic Brewing Recipe

[Table content]

automationrecipesbatchsequences