diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 00000000..16fba08e --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,2 @@ +ko_fi: kradalby +github: [kradalby] diff --git a/README.md b/README.md index 491450a5..cf246544 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,12 @@ The control server works as an exchange point of Wireguard public keys for the n headscale implements this coordination server. +## Support + +If you like `headscale` and find it useful, there is sponsorship and donation buttons available in the repo. + +If you would like to sponsor features, bugs or prioritisation, reach out to one of the maintainers. + ## Status - [x] Base functionality (nodes can communicate with each other) diff --git a/docs/README.md b/docs/README.md index cc3b3bae..1ac15221 100644 --- a/docs/README.md +++ b/docs/README.md @@ -11,6 +11,7 @@ please ask on [Discord](https://discord.gg/XcQxk2VHjx) instead of opening an Iss - [Running headscale on Linux](running-headscale-linux.md) - [Control headscale remotly](remote-cli.md) +- [Using a Windows client with headscale](windows-client.md) ### References diff --git a/docs/images/windows-registry.png b/docs/images/windows-registry.png new file mode 100644 index 00000000..1324ca6c Binary files /dev/null and b/docs/images/windows-registry.png differ diff --git a/docs/windows-client.md b/docs/windows-client.md index 2c8ecd56..e3e31d47 100644 --- a/docs/windows-client.md +++ b/docs/windows-client.md @@ -8,8 +8,10 @@ This documentation has the goal of showing how a user can use the official Windo To make the Windows client behave as expected and to run well with `headscale`, two registry keys **must** be set: -- `HKLM:\SOFTWARE\Tailscale IPN\UnattendedMode` must be set to `always` to allow Tailscale to run properly in the background -- `HKLM:\SOFTWARE\Tailscale IPN\LoginURL` must be set to `` to ensure Tailscale contacts the correct control server. +- `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. + +![windows-registry](./images/windows-registry.png) 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). @@ -37,6 +39,12 @@ in your `headscale` output, turn on `DEBUG` logging and look for: 2022-02-11T00:59:29Z DBG Machine registration has expired. Sending a authurl to register machine=redacted ``` -This typically means that the register keys above was not set appropriatly. +This typically means that the registry keys above was not set appropriately. -Ensure they are set correctly, delete Tailscale APP_DATA folder and try to connect again. +To reset and try again, it is important to do the following: + +1. Ensure the registry keys from the previous guide is correctly set. +2. Shut down the Tailscale service (or the client running in the tray) +3. Delete Tailscale Application data folder, located at `C:\Users\\AppData\Local\Tailscale` and try to connect again. +4. Ensure the Windows node is deleted from headscale (to ensure fresh setup) +5. Start Tailscale on the windows machine and retry the login.