Deploy Tailscale on Windows using MDM
This topic contains technical information which you might find useful if you are a system administrator deploying Tailscale for Windows in a corporate environment using MDM.
We are actively working on providing more options for system administrators to programmatically manage their Tailscale deployments. If you are deploying Tailscale and feel the need for a specific configuration option that is currently missing in this topic, open a GitHub issue.
Registry values can be set manually or via MDM, allowing you to alter the behavior of the Tailscale client.
Registry values should be stored in the
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Tailscale registry key.
HKEY_LOCAL_MACHINE\Software\Tailscale IPNkey. If you still have the
HKEY_LOCAL_MACHINE\Software\Tailscale IPNkey, move all of your custom policy settings into the
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Tailscalekey, and then delete the
HKEY_LOCAL_MACHINE\Software\Tailscale IPNkey to ensure everything is removed from the legacy registry key.
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Tailscale registry key:
(Default)value is not used.
Optionally, several values can be created, all of which are of String type:
LoginURLvalue contains the URL of the login server. The default value is
LogTargetvalue contains the URL of the log server. The default value is
Preference policies can be set to
user-decides. If set to
never, the options are
set by the administrator and not visible in the system tray menu. If unset or set to
user-decides then the option is
visible in the system tray menu.
AllowIncomingConnectionscontrols the Allow Incoming Connections menu option
UnattendedModecontrols the Unattended Mode menu option
Visibility policies can be set to “hide” or “show”. If set to “hide” then the menu item is not visible. If set to “show” or unset, then the menu item is visible.
AdminConsolecontrols the Admin Console menu item
NetworkDevicescontrols the Network Devices submenu
TestMenucontrols if the test/debug menu items are visible when opening the tray menu while pressing the
UpdateMenucontrols the Update Tailscale menu item
Duration policies control a duration or timeout. The time can be set using units of hours and minutes. Examples:
168h: 1 week
24h: 1 day
1h5m: 1 hour, 5 minutes
30m: half hour
- Smaller time units are available but unlikely to be useful. Non-negative values accepted by the Go time.ParseDuration function are supported.
Current duration policies:
KeyExpirationNoticecontrols how long before key expiry should a notice be displayed. The default is 24 hours.
For a full list of the registry values you can configure, check out our MDM configuration keys list.