From 036ff1cbb9e09916a55e3891b76448ba4289e57e Mon Sep 17 00:00:00 2001 From: Sean Reifschneider Date: Tue, 4 Apr 2023 00:58:32 -0600 Subject: [PATCH] Adding Powershell commands to Windows instructions (#1299) Co-authored-by: Kristoffer Dalby --- docs/windows-client.md | 9 +++++++++ templates/windows.html | 13 +++++++++++-- 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/docs/windows-client.md b/docs/windows-client.md index e3e31d47..fcb8c0e5 100644 --- a/docs/windows-client.md +++ b/docs/windows-client.md @@ -11,8 +11,17 @@ To make the Windows client behave as expected and to run well with `headscale`, - `HKLM:\SOFTWARE\Tailscale IPN\UnattendedMode` must be set to `always` as a `string` type, to allow Tailscale to run properly in the background - `HKLM:\SOFTWARE\Tailscale IPN\LoginURL` must be set to `` as a `string` type, to ensure Tailscale contacts the correct control server. +You can set these using the Windows Registry Editor: + ![windows-registry](./images/windows-registry.png) +Or via the following Powershell commands (right click Powershell icon and select "Run as administrator"): + +``` +New-ItemProperty -Path 'HKLM:\Software\Tailscale IPN' -Name UnattendedMode -PropertyType String -Value always +New-ItemProperty -Path 'HKLM:\Software\Tailscale IPN' -Name LoginURL -PropertyType String -Value https://YOUR-HEADSCALE-URL +``` + The Tailscale Windows client has been observed to reset its configuration on logout/reboot and these two keys [resolves that issue](https://github.com/tailscale/tailscale/issues/2798). For a guide on how to edit registry keys, [check out Computer Hope](https://www.computerhope.com/issues/ch001348.htm). diff --git a/templates/windows.html b/templates/windows.html index 1b4ae074..db9315ef 100644 --- a/templates/windows.html +++ b/templates/windows.html @@ -74,7 +74,7 @@ clicking the icon in the system tray -

Or

+

Or using REG:

Open command prompt with Administrator rights. Issue the following commands to add the required registry entries: @@ -83,7 +83,16 @@ REG ADD "HKLM\Software\Tailscale IPN" /v UnattendedMode /t REG_SZ /d always REG ADD "HKLM\Software\Tailscale IPN" /v LoginURL /t REG_SZ /d "{{.URL}}" -

Restart Tailscale and log in.

+

Or using Powershell

+

+ Open Powershell with Administrator rights. Issue the following commands to + add the required registry entries: +

+
+    New-ItemProperty -Path 'HKLM:\Software\Tailscale IPN' -Name UnattendedMode -PropertyType String -Value always
+      New-ItemProperty -Path 'HKLM:\Software\Tailscale IPN' -Name LoginURL -PropertyType String -Value "{{.URL}}"
+  
+

Finally, restart Tailscale and log in.