Quick answer
Install the Home Assistant Companion app on your iPhone, iPad or Android phone, and sign in to your Home Assistant address. Then build a phone dashboard under Settings, then Dashboards. Remote access needs either Nabu Casa or your own secure HTTPS setup.
Install the Companion app
- iOS and iPadOS: install the Companion app from the App Store.
- Android: install it from Google Play. The full version has every feature. The F-Droid “minimal” version leaves out features that depend on Google services.
- Sign in with your Home Assistant address and the account you use for the web interface.
Connect at home and away
The app can use two addresses. The internal address works on your home network, and the external address works everywhere else. Set the internal address and your home Wi-Fi network name, so the app uses the local address when you’re at home.
For the external address, you have two main options:
- Nabu Casa: a paid subscription from the team behind Home Assistant. It includes remote access. Check the current pricing on its website.
- Your own HTTPS setup: a reverse proxy with a valid certificate, or a VPN such as Tailscale or WireGuard.
Is there a monthly fee? Home Assistant itself is free and open source. Nabu Casa is an optional subscription, and running your own VPN or reverse proxy avoids it. That route takes more setup and upkeep.
Build a phone dashboard
A phone dashboard works best with a few things you use often:
- Start with tasks. Build buttons for scenes such as “Good morning” or “Away”, rather than one button per light.
- Keep it to one or two columns. Phone screens are narrow, so a short layout is easier to read.
- Show cards only when they matter. Visibility conditions can hide climate controls unless the heating or cooling is running.
- Start from a template if you like. Mobile-First is a minimalist community layout. HA-Mobile-Dashboard-Config on GitHub has raw YAML files, but it needs HACS cards such as Mushroom, Button Card and card-mod.
Use the dashboard basics guide for views and cards, and the themes guide if you want a different look on your phone.
Android Auto
The Companion app for Android supports Android Auto and Android Automotive OS. Once it’s set up, you can:
- toggle lights, locks, covers such as garage doors, scripts and simple switches;
- navigate to zones, people, sensors or device trackers that have a location;
- receive Home Assistant notifications on the car’s display;
- expose your phone’s connection state, so automations can run when you connect, for example to open a garage door.
To set it up, install and sign in to the Companion app on your Android phone, connect the phone to Android Auto, and open the Home Assistant icon in the car’s app launcher. For Android Automotive OS cars, install the app in the car itself.
The car screen has a simplified interface. Full web dashboards, live camera feeds and complex controls, such as alarm keypads, aren’t available there.
CarPlay and iPhone users
Car setup happens inside each companion app. Android Auto settings live in the Android app, so they can’t be set up from an iPhone. A feature request on GitHub (discussion 5034) proposes a single car interface configured in Home Assistant’s web interface. Check whether it has shipped before you rely on it.
Use an old phone as a fixed display
An old phone can work as a desk or bedside panel. The WallPanel plugin, installed through HACS, or a kiosk setup can hide the browser bars and keep the view full-screen. The wall-mounted touchscreen guide covers kiosk setups in more depth.
Troubleshooting
- The app can’t connect at home. Check the internal address and the home Wi-Fi network name in the app’s settings.
- The app can’t connect away from home. Check the external address, and confirm that remote access works in a mobile browser on cellular data.
- Your device is missing from the map. Check the phone’s location permission and the device tracker entity. The map card guide explains the coordinates to look for.
- Android Auto doesn’t show Home Assistant. Check that you’re signed in to the Android app and that the phone is connected to the car.