# IoT Setup Guide

Demeter turns soil, climate, and weather sensors into automatic care. This guide
covers pairing devices, watching their data, and getting alerted — the
foundation for [automation](automation.md).

## Pair a sensor

1. Go to **Sensors → Pairing** (`/sensors/pairing`).
2. Choose how the device connects:
   - **Direct protocol** — MQTT, Zigbee, Z-Wave, Matter/Thread, Wi-Fi, BLE, or
     LoRa. See [IoT device protocols](../protocols/iot-device-protocols.md) for
     ranges and trade-offs (LoRa for far outdoor sensors, Zigbee/Thread
     indoors).
   - **A platform integration** — GARDENA, Rachio, Ecowitt, Home Assistant, and
     more. See the
     [integration guide](../integrations/third-party-integrations.md).
3. Assign the sensor to a **garden** (and optionally a **bed**), name it, and
   set its location. It now streams readings.

## Watch the data

- **Sensors** (`/sensors`) — all devices, current values, and battery levels.
- **Sensor detail** (`/sensors/:id`) — one device's live + historical readings.
- **Visualization** (`/sensors/visualization`) and **History**
  (`/sensors/history`) — charts and trends over time.
- **Monitoring** (`/sensors/monitoring`) — a live overview across devices.

## Get alerted

**Alerts** (`/sensors/alerts`) lets you set per-sensor, per-metric thresholds
(e.g. "soil moisture below 25%", "temperature above 32°C"). When a threshold is
crossed you're notified by your chosen channels (email/push), with severity
(info/warning/critical) and escalation if it goes unacknowledged.

## Calibrate & maintain

Each sensor tracks a **calibration** timestamp and **battery** level;
recalibrate from the device page to keep readings trustworthy. Malformed or
out-of-range payloads are rejected so a faulty device can't corrupt your
history.

## Next

Turn readings into action: set up rules so low moisture opens a valve, or heat
opens a vent — see [Automation](automation.md).
