Where Does Home Assistant Companion Store Settings?
The Companion app holds server connection settings, device sensors, and notification tokens per phone. Automations and history live on the server.
Last updated
The Companion app is a remote dashboard plus a sensor bundle. Server URLs, login tokens, notification settings, and per-device sensor toggles live in private app storage. Dashboards, automations, and history stay on the Home Assistant server itself.
That split decides troubleshooting: server problems need the server logs, while missing sensors need the app settings. Exact folder names may vary by version, so configure connections in-app. Clean up stale device entries on the server after phone upgrades or presence detection haunts the old handset.
Where Home Assistant Companion stores this, by platform
/storage/emulated/0/Android/data/io.homeassistant.companion.android/files
Connection settings and sensors per device; server holds the rest. Exact folder names may vary by version. Fresh login needed after reinstalls for notifications.
Companion app storage (Settings > iPhone Storage)
Same per-device model as Android with iOS sensor set. Delete stale phone entries on the server after upgrades to fix presence.
Frequently asked questions
How do I connect the app to my server?
Add the server URL and log in; sensors enroll per device with names you set in the app. Enable location, battery, and activity sensors selectively since each costs power. The server sees new entities after the next update cycle.
Why did notifications stop after reinstalling?
Open the app settings and check the connection list for internal and external URLs. Notifications arrive through the persistent token, so reinstalls need a fresh login before alerts resume. Old device entries linger on the server until deleted.
Notice an outdated path? Let us know.