See everything you missed at TailscaleUp.Read the recap →

Configure Tailscale clients to use a custom control server

Last validated:

The Tailscale clients let you specify a custom control server URL instead of the default https://controlplane.tailscale.com server. If you are using a self-managed deployment of Headscale as your control plane, use your Headscale instance's URL.

Add a custom control server

macOSWindowsLinuxiOSAndroidtvOS
  1. Tap the user profile icon in the top-right corner of the Tailscale app to open Settings.
  2. If you are not signed in to any other tailnets, tap Log in. Otherwise, tap the signed-in user.
  3. Tap the ellipsis icon menu in the top-right corner, then select Use a custom coordination server.
  4. Enter the custom control server URL and tap Log in.

Remove a custom control server

macOSWindowsLinuxiOSAndroidtvOS
  1. Tap the user profile icon in the top-right corner of the Tailscale app to open Settings.
  2. Tap the active account details to open the account switcher.
  3. Press and hold the custom control server account you want to remove.
  4. Confirm that you want to remove the account.

Pressing and holding the account lets you remove the profile even if the custom control server is offline or unreachable and the normal logout process fails.