diff --git a/manage/clients/configure-client.mdx b/manage/clients/configure-client.mdx index 1ee8e71..538e1f6 100644 --- a/manage/clients/configure-client.mdx +++ b/manage/clients/configure-client.mdx @@ -49,13 +49,41 @@ This is a fallback DNS server that the system can use if the primary server is u ## Windows Client (Advanced) -On Windows, you can preconfigure the Pangolin GUI client by editing the JSON config at `%LOCALAPPDATA%\Pangolin\pangolin.json` before the user signs in. This file uses the following fields: +On Windows, you can preconfigure the Pangolin GUI client by editing the JSON config at `%LOCALAPPDATA%\Pangolin\pangolin.json` before the user signs in (for example, `C:\Users\USER\AppData\Local\Pangolin\pangolin.json`). -- **DNSOverride** / **DNSTunnel**: Match the **Enable Aliases (Override DNS)** and **DNS Over Tunnel** preferences, controlling whether the client takes over DNS and whether DNS goes through the tunnel. -- **PrimaryDNS** / **SecondaryDNS**: Set the upstream DNS servers used when override/tunnel DNS is enabled. -- **DefaultServerURL**: When set, skips the deployment option screen; all login flows start directly with this server URL. -- **AuthPath**: Optional path appended to the server URL for authentication, for example `/auth/org/my-org` to always send users to a specific organization or branded login page. Most deployments should leave this unset. -- **UserSettingsDisabled**: Disables the settings form in the GUI so users cannot change these values themselves. + + JSON configuration for the Windows Pangolin client stored in `pangolin.json`. + + + + When true, matches the **Enable Aliases (Override DNS)** preference and lets the client take over DNS resolution for Pangolin resources. + + + + When true, matches the **DNS Over Tunnel** preference and sends DNS queries through the Pangolin tunnel. + + + + Primary upstream DNS server used when override/tunnel DNS is enabled. + + + + Optional secondary upstream DNS server used as a fallback when the primary is unavailable. + + + + When set, skips the deployment option screen during login; all login flows start directly with this server URL. + + + + Optional path appended to the server URL for authentication, for example `/auth/org/my-org` to always send users to a specific organization or branded login page. Most deployments should leave this unset. + + + + When true, hides and disables the settings form in the GUI so users cannot change these values themselves. + + + As a system administrator, you can script placing this file into `%LOCALAPPDATA%\Pangolin\pangolin.json` to preconfigure user installations and automate rollouts.