mikedmor

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:

3. Connect the app

  1. Install Hearth from Google Play (coming soon) and open it.
  2. Enter your Hearth address, like https://start.home, and tap Connect. The app checks it really is Hearth.
  3. 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 saysWhat to do
The certificate isn't trustedInstall your home's certificate on the phone (step 2), or use your Tailscale address.
Couldn't find that addressCheck the spelling, and that the phone is on your home network or Tailscale.
It doesn't look like HearthThe address reaches something else: check the port and the reverse proxy.