-
Notifications
You must be signed in to change notification settings - Fork 0
Built to Be Efficient
Device Sentinel watches every device in your home and remembers what it learns, which means it writes to disk. On a machine with an SSD the cost is negligible. On a Raspberry Pi running from an SD card, repeated small writes are among the few things that genuinely shorten the life of the hardware, so the integration's storage design treats write volume as a constraint rather than an afterthought. This page describes how that works and which settings matter if your storage is the fragile kind.
Storage is divided between two files according to how often the data changes. A small file carries the per-device values that move whenever a device reports, such as the activity clock and current signal reading, while a large file carries everything learned over time: the daily history, the verdicts, the problem list, and the recent incident and silence records. Because a device reporting normally only touches the small file, the large one is spared the churn of ordinary activity entirely.
Routine changes are also coalesced rather than written as they occur. When a device reports and its clock advances, that change is held in memory and saved together with everything else that accumulated during the storage write interval, on a single schedule. The large file is written on that same schedule, and only when something worth keeping has happened since its last write, so on a settled system it is touched a handful of times a day.
Coalescing never applies to anything a restart must not lose. A device going silent, a battery crossing your threshold, an item added to or checked off the problem list: these are written to both files the moment they happen, and both files are written once more at every clean shutdown. The exposure in a power cut is therefore limited to at most one interval of routine clock progress, which repairs itself as each device reports again.
The four Markdown reports are written at startup, at midnight, at your daily brief time, and when you press the Regenerate Reports button, never continuously in the background.
Both are on the [Advanced](Advanced) screen. The storage write interval, five to sixty minutes with a default of fifteen, sets how long routine changes are held before being saved; a longer interval means fewer writes in exchange for slightly more of the self-repairing clock data at risk during a power cut, and it is the most effective single adjustment if write volume concerns you. How much history to keep, thirty days to a year with a default of ninety, determines how many days of per-device daily history are retained and therefore how large the big file eventually grows.
For an SD card installation, a thirty-minute interval with the default history is a sensible pairing. On an SSD the defaults are fine and the subject needs no further thought.
Device Sentinel is brought to you by James Lander at The Thinking Home. Read the story behind it: Reliable Home Assistant Dead Sensor Detection.
Repository · Report an Issue · Releases · Blueprints
Licensed under GPL-3.0-or-later. Copyright © 2026 James Lander.
Start Here
Configuration
- The Device Page
- Notifications and Daily Brief
- Exclusions and Muting
- Low Battery
- Signal Strength
- Freeze Detection
- Advanced
The Reports
Automations
Understanding
- How Device Sentinel Learns
- Maintenance Mode
- The Bridge and Broker Sensors
- What Is Recorded About Your House
- Built to Be Efficient
Coordinator Stacks
Help