mirror of https://github.com/juanfont/headscale.git synced 2025-10-19 11:15:48 +02:00

Florian Preinstorfer 7b8b796a71 docs: connect Android using a preauthkey

Fixes: #2616

2025-08-18 16:06:17 +02:00

Connecting an Android client

This documentation has the goal of showing how a user can use the official Android Tailscale client with headscale.

Installation

Install the official Tailscale Android client from the Google Play Store or F-Droid.

Open the app and select the settings menu in the upper-right corner
Tap on Accounts
In the kebab menu icon (three dots) in the upper-right corner select Use an alternate server
Enter your server URL (e.g https://headscale.example.com) and follow the instructions
The client connects automatically as soon as the node registration is complete on headscale. Until then, nothing is visible in the server logs.

Open the app and select the settings menu in the upper-right corner
Tap on Accounts
In the kebab menu icon (three dots) in the upper-right corner select Use an alternate server
Enter your server URL (e.g https://headscale.example.com). If login prompts open, close it and continue
Open the settings menu in the upper-right corner
Tap on Accounts
In the kebab menu icon (three dots) in the upper-right corner select Use an auth key
Enter your preauthkey generated from headscale
If needed, tap Log in on the main screen. You should now be connected to your headscale.