Configure Tailscale clients to use a custom coordination server
The Tailscale clients let you specify a custom coordination server URL instead of the default https://controlplane.tailscale.com server. If you are using a self-managed deployment of Headscale as your coordination server, use your Headscale instance's URL.
Add a custom coordination server
If you're using the App Store or Standalone variants of the Tailscale client, you can add a custom coordination 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 coordination server URL and select Add account.
Alternatively, to sign in with a custom coordination server URL from the Tailscale CLI, run the following command. Replace <URL> with your custom coordination server URL.
tailscale login --login-server=<URL>
Remove a custom coordination server
To remove a custom coordination server account using the Tailscale user interface:
- Select the Tailscale icon in the macOS menu bar.
- Choose Settings from the menu.
- Select the Accounts tab.
- Select the custom coordination server account.
- Log out of the account.
Alternatively, use the Tailscale CLI:
tailscale logout