Hearth for Android
Set up Hearth
Hearth is the family's start page for the home network: every service, everyone's calendar and live widgets. The app connects to your Hearth: set that up first, then point the app at it.
1. Run Hearth at home
Hearth is one Docker container. Follow the install guide, open it in a browser, enter the setup code from the container's log and choose the admin password.
2. Give it an https address your phone trusts
The app only connects over https://. Either works:
- Tailscale, using the https name it gives you.
- A home name such as
https://start.home, with your home's certificate installed on the phone. Hearth walks you through it: see Trusting your home's certificate.
3. Connect the app
- Install Hearth from Google Play (coming soon) and open it.
- Enter your Hearth address, like
https://start.home, and tap Connect. The app checks it really is Hearth. - Pick your face on Who's here?, as on any screen in the house.
Want the app to ask for a fingerprint or screen lock? Press and hold its icon → Server and lock.
If something's wrong
| The app says | What to do |
|---|---|
| The certificate isn't trusted | Install your home's certificate on the phone (step 2), or use your Tailscale address. |
| Couldn't find that address | Check the spelling, and that the phone is on your home network or Tailscale. |
| It doesn't look like Hearth | The address reaches something else: check the port and the reverse proxy. |