Set up your phone

Follow these steps in order, on an Android phone. It takes about ten minutes, and each step says why it matters.

  1. Install the Home Assistant app

    Open the Play Store on your phone, make sure you are signed in to your own Google account, search for Home Assistant and tap Install.

    Why: This is the app that tells the house where your phone is.

  2. Connect to the server

    Open the app and tap Connect to server. Choose to type the address in yourself rather than picking one from the list the app finds. Use the address that works from outside the house. Eric will give you the address.

    Why: An address that only works at home stops sending your location the moment you leave, which is exactly when it matters.

  3. Log in with your own account

    When the app asks for a username and password, use the ones made for you, never someone else’s.

    Why: The phone gets attached to whoever logs in, so arrivals would be reported for the wrong person.

  4. Name your phone

    When the app asks for a device name, type your first name, then _phone, all in lowercase, for example kayla_phone. Then tell Eric the exact name you used.

    Why: A predictable name lets Eric find your phone quickly and link it to you.

  5. Allow location all the time

    On your phone open Settings → Apps → Home Assistant → Permissions → Location. Choose Allow all the time and turn on Use precise location.

    Why: The default, “Only while using the app”, quietly stops location updates whenever the app is closed.

  6. Allow notifications

    If your phone asks whether Home Assistant can send notifications (Android 13 and newer does), tap Allow. If it never asked, go to Settings → Apps → Home Assistant → Notifications and switch them On.

    Why: Without this, alerts and sign-in approvals never show up on your phone.

  7. Battery: let the app keep running

    Go to Settings → Apps → Home Assistant → Battery and choose Unrestricted. On the same app screen, turn off Pause app activity if unused (some phones call it Remove permissions if app isn’t used). On a Samsung phone, also go to Settings → Battery → Background usage limits and add Home Assistant to Never sleeping apps.

    Why: Otherwise the phone puts the app to sleep and arrivals show up minutes late, or never.

  8. Turn on the sensors

    Open the Home Assistant app and go to Settings → Companion app → Manage sensors. Turn on Background location, Detected activity (tap Allow if it asks for Physical activity) and Battery level.

    Why: Detected activity is off by default, and the house needs these to know when you are on the move and tell drives from hikes.

  9. Hide the high-accuracy notification (optional)

    During a trip, the Home Assistant app shows an ongoing notification about using high-accuracy location. This is normal and expected. If you want to hide it, long-press the notification and turn off that notification category. The exact wording varies between Android versions, but the option is always there.

    Why: The app needs high-accuracy location while you are traveling, so it shows you it is doing this.

  10. Check your Private DNS setting

    On your phone go to Settings → Network & internet → Private DNS and choose Off or Automatic. Do not pick a named provider such as dns.google.

    Why: With a named provider, links in notifications (like sign-in approvals) can’t open on home Wi-Fi and just spin.

  11. Tell Eric you are done

    Let Eric know, so your phone can be linked to you and alerts can reach you.

    Why: Alerts only start once your phone is linked, so wait to hear back from Eric before testing.

  12. Check that it works

    Walk away from home and back again, or wait for Eric to send you a test alert. You should get a notification, and tapping it should open the app.

    Why: It is much better to find a problem now than the first time it really matters.

  13. Sign in to this website

    On your phone, open this website, type your name, choose Send a sign-in link and tap the link that arrives. On a computer, choose Show me a code and approve it on your phone.

    Why: Your phone is how the website knows it is really you.

If something isn't working

  • Notifications arrive late: check step 7 (Battery).
  • The sign-in link just spins while you are on home Wi-Fi: check step 9 (Private DNS), or switch to mobile data and try again.
  • Nothing at all after you leave home: check steps 5 (Location) and 8 (Sensors).