Configure Tailscale clients to use a custom control server
The Tailscale clients allow you to 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.
If you're using the App Store or Standalone variants of the Tailscale client, you can add a custom control server URL in the Tailscale user interface:
The following instructions only work when at least one other tailnet has been authenticated in the client. If no other tailnets have been added to the device, use the Tailscale CLI instructions instead.
- Select the Tailscale icon in the macOS menu bar.
- Choose Settings from the menu.
- Select the Accounts tab.
- Select the down arrow in the lower left corner of the window.
- Enter your custom control server URL and select Add account.
Alternatively, to sign in with a custom control server URL from the Tailscale CLI, run the following command. Replace <URL> with your custom coordination server URL.
tailscale login --login-server=<URL>