Thesada Documentation

Thesada is an open-source modular property monitoring platform built on ESP32 hardware with custom C++ firmware, MQTT over TLS, cellular fallback, and Lua scripting. Designed for rural and off-grid deployments where reliability matters.

What it does

  • Monitors - temperature (DS18B20, SHT31), current (ADS1115 + CT clamp), battery voltage and charge state
  • Alerts - Lua-defined alert rules with sustain, cooldown, and hysteresis via MQTT, Telegram, or webhook
  • Logs - CSV data to SD card, logrotate included
  • Updates - over-the-air via HTTP push or pull (TLS-verified, SHA256 checked, PROGMEM CA fallback)
  • Scripted - Lua 5.3 runtime for custom rules without recompiling

Where to start


Thesada - GPL-3.0-only (firmware) / CC BY-NC-SA 4.0 (docs) - License

This site uses Just the Docs, a documentation theme for Jekyll.