Skip to content

FAQ and Troubleshooting

TheThinkingHome edited this page Jul 17, 2026 · 27 revisions

FAQ and Troubleshooting

Why is Devices Watched lower than my device count? Devices with no hardware behind them (service entries, cloud connections, integration containers) are classified out automatically; they are the Service Devices Ignored count. The rest of the difference is your own exclusions. The classification report names where every device landed; see The Reports.

Why is Devices Learned zero, or low? Each device needs enough completed days to establish a rhythm, seven by default. A fresh install reads zero for its first week; that is the system working, not stalling. Some devices never arm at all: buttons and remotes have no heartbeat to learn, by design.

Why does Status say Learning? No device has established its rhythm yet. It flips to Watching at the first one and stays there.

I excluded something, will it have to re-learn when I un-exclude it? No. Excluded items are still watched and learned; only reporting is suppressed. Undoing an exclusion is instant and complete.

Why does nothing reach my phone? Two possibilities. Targets are not set: see Notifications. Or you are on a release before the notification engine ships; the settings are stored and honored the moment it arrives.

Why did my entity IDs change? Release 0.3.12 renamed entities so their IDs say what they count (devices_watched, devices_learned, and so on). Existing installations were migrated automatically, one logged rename each. Dashboards and automations referencing the old IDs need pointing at the new ones once; the table is in the 0.3.12 release notes.

A battery is one percent above my threshold and still flagged. A flagged battery clears at 2 points above the threshold, not 1. The margin exists because battery readings rebound under load; without it, a cell at the line would flap in and out of the report.

Something looks wrong. What do you need from me? Download Diagnostics: Settings, Devices and Services, Device Sentinel, three-dot menu, Download Diagnostics. Attach it to an issue at the issue tracker. It carries the learned state, the settings in effect, and the classification, and answers most questions without screenshots. Notification targets are redacted automatically.

Clone this wiki locally