mirror of
https://github.com/juanfont/headscale.git
synced 2024-12-04 20:53:06 +00:00
2.5 KiB
2.5 KiB
Connecting an Apple client
This documentation has the goal of showing how a user can use the official iOS and macOS Tailscale clients with headscale.
!!! info "Instructions on your headscale instance"
An endpoint with information on how to connect your Apple device
is also available at `/apple` on your running instance.
iOS
Installation
Install the official Tailscale iOS client from the App Store.
Configuring the headscale URL
- Open Tailscale and make sure you are not logged in to any account
- Open Settings on the iOS device
- Scroll down to the
third party apps
section, underGame Center
orTV Provider
- Find Tailscale and select it
- If the iOS device was previously logged into Tailscale, switch the
Reset Keychain
toggle toon
- If the iOS device was previously logged into Tailscale, switch the
- Enter the URL of your headscale instance (e.g
https://headscale.example.com
) underAlternate Coordination Server URL
- 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.
- Enter your credentials and log in. Headscale should now be working on your iOS device.
macOS
Installation
Choose one of the available Tailscale clients for macOS and install it.
Configuring the headscale URL
Command line
Use Tailscale's login command to connect with your headscale instance (e.g https://headscale.example.com
):
tailscale login --login-server <YOUR_HEADSCALE_URL>
GUI
- ALT + Click the Tailscale icon in the menu and hover over the Debug menu
- Under
Custom Login Server
, selectAdd Account...
- Enter the URL of your headscale instance (e.g
https://headscale.example.com
) and pressAdd Account
- Follow the login procedure in the browser
tvOS
Installation
Install the official Tailscale tvOS client from the App Store.
!!! danger
**Don't** open the Tailscale App after installation!
Configuring the headscale URL
- Go Settings (the apple tvOS settings) > Apps > Tailscale
- Under
ALTERNATE COORDINATION SERVER URL
, selectURL
- Enter the URL of your headscale instance (e.g
https://headscale.example.com
) and pressOK
- Return to the tvOS Home screen
- Open Tailscale
- Click the button
Install VPN configuration
and confirm the appearing popup by clicking theAllow
button - Scan the QR code and follow the login procedure