The phone app and your server
Hearth installs on a phone from the server you opened it on. The app has a Hearth server address setting, so a company that runs its own Hearth can point the app at it.
Open Settings, then Phone app, then Hearth server address. You can also choose Use a different Hearth server on the sign-in page, or go to /connect. Type the address, for example hearth.example.com. Hearth adds https:// for you. For a server on your own network, type the full address with its port.
- The phone asks that address for
/.well-known/hearth, which every Hearth answers with a few words that say what it is. If nothing answers, or what answers is not a Hearth, the page says so and nothing is saved. - When it answers, the phone remembers the address and opens that server's sign-in.
- After that,
/loginon any server this phone opens goes straight to the one it remembers. Use this server instead on the connect page forgets the address, and/login?local=1signs in on the server you are on without forgetting it.
The check is made by the phone itself, so it proves the phone can reach the server, not only that the server exists. The connect page holds nothing of any installation and needs no sign-in.