Home Assistant
Guest mode
A guest dashboard with lights, heating and wifi, and nothing that can break the house.
AuthorAitana Ferrer
PublishedMay 2026
LicenseApache-2.0
Installs391
Why it exists
Handing a guest your Home Assistant is either a lecture or a liability. Grandparents do not need the automation editor; they need the thermostat and the wifi password.
This mod publishes a separate guest dashboard behind a scoped account: a handful of controls, big labels, no admin surface, and a QR invite that expires when the visit ends.
What it does
- Scoped guest account with an expiring QR invite
- Curated dashboard: lights, climate, wifi
- No access to settings, automations or history
- Sessions end automatically when the invite expires
The spec
These acceptance criteria were written with the person who requested the mod, then locked in as its tests. The mod has to pass them on every new release train before it rides along.
- A guest session cannot reach any admin route, even by direct URL
- Expired invites stop working within a minute, open sessions included
mods/guest-mode/tests/test_scope.py
def test_guest_cannot_reach_admin_routes():
guest = invite_guest(expires_in=hours(48))
for route in ADMIN_ROUTES:
response = guest.get(route)
assert response.status == 403