Think of our home server as a house at the end of a private road. The internet is the public highway, anyone can drive it, but they can't turn onto our road. Tailscale is the gate key that lets your device onto that private road.
THE INTERNET ยท the public highway
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ anyone can drive this highway, but there is no turn-off โ
โ that reaches us, so strangers never even find the road โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ
โ YOUR DEVICE โ โ HOME SERVER โ
โ (anywhere) โ โโโโ encrypted private road โโโบ โ (at home) โ
โ holds the โ only your device can use it โ movies, โ
โ gate key โ โ photos & โ
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ
โฒ โฒ
โ the auth key โ nothing here is
โ opens the gate โ exposed publicly
Get the free Tailscale app from the App Store (iPhone) or Google Play (Android), or on a Google/Apple TV. Open it once, then follow the screens below.
Tailscale is the secure tunnel between your device and our server, it only carries traffic to our house, and does not watch or reroute your normal browsing.
Open the menu / account icon in the top corner of the Tailscale app.
Choose Use an auth key, paste the key the admin texts you, then Log in, you're on instantly: nothing to request, no approval to wait for.
We run our own coordination server (Headscale), so you point Tailscale at ours: enter https://headscale.tiruviluamala.com as the server, paste your key, then Login.
The main switch should be green / connected, you're on the network โ . If asked, turn on MagicDNS and Allow LAN access.
You're on the network. Now get the app that plays our movies & shows.
https://).Streamyfin is built for exactly this. You sign in with your account and it just works, no settings to fiddle with, smooth playback, downloads for offline. For 95% of people the whole job is: install Streamyfin โ enter the server โ log in โ done.
| Problem | Fix |
|---|---|
| App won't load / spins forever | Tailscale is probably off. Open it, make the switch green, retry. |
| "Can't connect to server" | Check the address starts with https:// (the s). Make sure Tailscale is on first. |
| Worked before, now it doesn't | Toggle Tailscale off/on. Turn off Low Power Mode / any other VPN. |
| Movie is choppy | Make sure you're using the app, not a browser. If it persists, ask the admin, it may be a server-side encoding setting. |
| Want a movie that isn't there | Use the Request page on the family home page (the admin will share the address). |
| Term | What it is | Analogy |
|---|---|---|
| Tailscale | The app that puts your device on our private network | The gate key to a private road |
| Headscale | Our own server that runs the network | Owning the gate instead of renting it |
| Auth key | Your personal sign-in code for the network | Your copy of the gate key |
| Streamyfin | The phone apps that play our movies & shows | The TV remote |
| MagicDNS | Lets you use nice names instead of number addresses | Saved contacts instead of phone numbers |