Skip to content
TheThinkingHome edited this page Aug 8, 2026 · 30 revisions

Device Sentinel

Device Sentinel watches your hardware. It detects frozen devices (silent but showing a healthy value), unavailable devices, and low batteries, by learning each device's own reporting rhythm and setting per-device freeze windows automatically. Every detection reaches a problem list you act on, and a daily brief writes it up in plain language and emails it on its schedule.

Everything runs on sensible defaults from the moment it is installed. There is one thing to configure: for alerts to reach your phone, Device Sentinel must be told where to send them, on the Notifications and Daily Brief screen.

Getting Started

  • Installation and Setup: what you need, the five minutes it takes, and the one Home Assistant setting worth getting right first.

The Configuration Screens

Open Settings, then Devices and Services, then Device Sentinel, then Configure.

The Device Sentinel configuration screens in Home Assistant

  • Notifications and Daily Brief: where alerts go, quiet hours, and when the daily brief is sent.
  • Global Exclusions: hardware you never want judged or reported, by anything.
  • Low Battery: the low threshold, how far ahead a falling cell is flagged, and battery-only excludes.
  • Signal Strength: how weakening radio links are judged against a line just above each device's own learned floor, and the colored dwell chart that puts the whole fleet on one page. Three sliders tune it.
  • Freeze Detection: how long a device may go quiet before it is called frozen, unavailable, or unknown. Set by two grace sliders.
  • Advanced: settings most people never need to change.
  • Maintenance Mode: the button you press before working on hardware, so your repairs are not learned as a device's normal behavior.

Understanding What It Does

Coordinator Stacks

Device Sentinel recognizes four and can read one. These pages say what each gets, and what would change that.

  • Zigbee2MQTT: fully read. Pairing windows, bridge outages, and a second opinion on every freeze verdict.
  • ZHA: detected only. What is known, what is unverified, and the captures that would change it.
  • Z-Wave: detected only. What is known, what is unverified, and the captures that would change it.

Reporting a Problem

Open an issue at the issue tracker and attach your diagnostics: Settings, Devices and Services, Device Sentinel, then the three-dot menu, then Download Diagnostics. The diagnostics carry the learned state and settings in effect and answer most questions without a screenshot. Notification targets are redacted automatically.

Clone this wiki locally