Repairs - TheThinkingHome/device_sentinel GitHub Wiki
Repairs
If Device Sentinel runs into a problem with its own plumbing, it will tap you on the shoulder using Home Assistant's built-in Repairs panel (under Settings).
Your devices never appear here. A frozen motion sensor, a dying battery, or a weak radio link belongs on The Problem List. If a sensor breaks, you check your to-do list. If Device Sentinel's own gears get jammed, you check Repairs.

Here are the issues you might see, and what to do about them.
The Issues
Storage Repaired / Storage Restored / Storage Structure Repaired
Device Sentinel fiercely protects its own memory. If a sudden power cut or a failing drive corrupts the file where it stores your home's rhythms, it doesn't crash. It catches the damage, repairs the file, or restores itself from an automatic last-good backup.
When it does this, it raises a Repair card to tell you exactly what it rescued and where it put the damaged original. Nothing is asked of you. You don't need to fix anything. Just press Submit to acknowledge it and clear the card.
The third card covers the same protection at a different level: part of the file held the wrong kind of value, which would have stopped Device Sentinel from starting, so it was repaired before anything else ran. It also names what was repaired and where the original went, and asks nothing of you.
Disabled Entities
Device Sentinel cannot learn from what it cannot see. Many integrations ship with their diagnostic entities, like battery percentages, signal strengths, or last_seen timestamps, disabled by default. If those are switched off, Device Sentinel will raise a card letting you know you are flying blind. The card names the devices it would change, up to ten of each kind, then how many more.
- Fix: Click Enable to turn on the missing entities across your watched devices.
- Ignore: If you disabled those entities on purpose, click Ignore. Device Sentinel will keep monitoring those devices for whatever else it can see, and the card will stay hidden.
Missing Notification Target
You told Device Sentinel to send alerts to a specific phone or companion app, but that service no longer exists in Home Assistant (usually because the app was removed or the phone was renamed). Device Sentinel is currently shouting alerts into the void, and its messages are failing.
- Fix: Click Remove Them to wipe the dead targets from Device Sentinel's settings.
- Ignore: Hides the card.
Nothing Configured
If Device Sentinel has been running for a week and you still haven't given it a place to send alerts or the daily brief, it will politely raise a card. It is watching your house, but it has no way to tell you if something goes wrong.
There is no "Fix" button for this, because where your alerts go is your decision. Head to Settings > Devices and Services > Device Sentinel > Configure > Notifications and Daily Brief to set up a target.
How Repairs Work
- They clean up after themselves. An issue is deleted the exact moment its cause clears. If you add a missing notification target, the Repair card instantly vanishes. A card never outlives the problem it describes.
- They don't nag during reboots. Everything in Home Assistant screams at once during a restart. Device Sentinel waits until the startup dust settles before evaluating if a Repair is actually needed.
- You are never trapped. Every issue with a "Fix" button also offers an "Ignore" option inside the fix screen. You are never left with a card you can only clear by accepting a change you didn't want.