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

The Tailscale user interface for Windows doesn't support adding a custom control server URL. You can use the Tailscale CLI or edit registry settings instead.

To sign in with a custom control server URL from the Tailscale CLI, run the following command. Replace <URL> with your custom control server URL.

tailscale login --login-server=<URL>

For more information, refer to Deploy Tailscale on Windows using MDM to use a custom control server URL by editing the LoginURL registry value. An MDM solution is not required. You can also edit the registry value directly.

Remove a custom control server

If you authenticated to the custom control server using the Tailscale CLI, run:

tailscale logout

If you configured the custom control server using the LoginURL registry value, remove the value from the applicable registry path:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Tailscale

or:

HKEY_CURRENT_USER\SOFTWARE\Policies\Tailscale

If an MDM solution manages the LoginURL value, remove or update the policy using that solution instead. Otherwise, the policy might be applied again.