Installation

Prerequisites

Create or sign in to a Tailscale account before installing the app. You can also authenticate during setup.

Add the repository

Use the Home Assistant repository redirect to open the repository dialog with the URL pre-filled.

To add it manually:

1. Open Settings > Add-ons > Add-on Store.
2. Open the three-dot menu and select Repositories.
3. Add https://github.com/rollingtail/home-assistant.
4. Close the dialog and wait for the store to refresh.
5. Search for Tailscale.

Install and authenticate

1. Open the Tailscale app in the store and select Install.
2. Start the app.
3. Open the app logs and confirm that it starts successfully.
4. Open the app's Web UI.
5. Follow the authentication link and authorize the Home Assistant device in Tailscale.
6. Check the logs again to confirm that the device is connected.

The Web UI authentication step is most reliable in a desktop Chrome browser.

Troubleshooting

• The app is not connected: check the app logs and reopen the Web UI authentication flow.
• The device disappears after some time: review key expiry in the Tailscale admin console and disable it for this device when appropriate.
• A subnet is unreachable: set advertise_routes, approve the route on the Tailscale Machines page, and confirm that the client accepts subnet routes.
• MagicDNS does not resolve: verify that MagicDNS is enabled and that userspace_networking is disabled when you need the Tailscale DNS resolver on the host.
• Connections are unreliable: test peer connectivity with tailscale ping <hostname-or-ip> and inspect whether your network blocks UDP.