headscale: iOS configuration

GUI

1. Install the official Tailscale iOS client from the App store
2. Open Tailscale and make sure you are not logged in to any account
3. Open Settings on the iOS device
4. Scroll down to the "third party apps" section, under "Game Center" or "TV Provider"
5. Find Tailscale and select it
   • If the iOS device was previously logged into Tailscale, switch the "Reset Keychain" toggle to "on"
6. Enter "{{.URL}}" under "Alternate Coordination Server URL"
7. Restart the app by closing it from the iOS app switcher, open the app and select the regular sign in option (non-SSO). It should open up to the headscale authentication page.
8. Enter your credentials and log in. Headscale should now be working on your iOS device

headscale: macOS configuration

Command line

Use Tailscale's login command to add your profile:

tailscale login --login-server {{.URL}}

GUI

1. ALT + Click the Tailscale icon in the menu and hover over the Debug menu
2. Under "Custom Login Server", select "Add Account..."
3. Enter "{{.URL}}" of the headscale instance and press "Add Account"
4. Follow the login procedure in the browser

Profiles

Headscale can be set to the default server by installing a Headscale configuration profile:

macOS AppStore profile macOS Standalone profile

1. Download the profile, then open it. When it has been opened, there should be a notification that a profile can be installed
2. Open System Preferences and go to "Profiles"
3. Find and install the Headscale profile
4. Restart Tailscale.app and log in

Or

Use your terminal to configure the default setting for Tailscale by issuing:

• for app store client: defaults write io.tailscale.ipn.macos ControlURL {{.URL}}
• for standalone client: defaults write io.tailscale.ipn.macsys ControlURL {{.URL}}

Restart Tailscale.app and log in.

Caution

You should always download and inspect the profile before installing it:

• for app store client: curl {{.URL}}/apple/macos-app-store
• for standalone client: curl {{.URL}}/apple/macos-standalone