Server-Side Client Settings

Manage DNS, exit node, and tunnel settings for user devices from a role

Only available in Pangolin Cloud on the Enterprise plan and self-hosted Enterprise Edition.

Server-side client settings let an admin set the connection settings for every user in a role, instead of asking each user to configure their own device. Use them to roll out a DNS setup, require an exit node, or tune the tunnel for a whole team at once.

Settings are configured per role. Each setting can be managed by the server or left to the client, so you only need to manage the settings you care about.

How It Works

Each time a Pangolin client connects to an organization, it fetches the settings for the signed-in user from the server. Settings managed by the server replace the device's own values and can't be changed on the device. Settings not managed by the server keep whatever the user chose.

On Mac, iOS/iPadOS, Windows, Linux, and Android, the client shows in Settings > Connection how many of its settings the organization manages, with a lock next to each one.

Users With Multiple Roles

Settings are never combined across roles. If a user has several roles that manage client settings, they get the settings of the oldest of those roles (the one created first). Roles with Manage settings from the server turned off are skipped.

To avoid conflicts, create a role just for client settings, such as Client Settings - Engineering, and manage settings only on that role. Leave Manage settings from the server off on your other roles. Add the role to users alongside their existing roles: it doesn't need access to any resources, so it only changes their client settings.

Configure Client Settings for a Role

  1. In the dashboard, go to Team > Roles and open the role.
  2. Open the Client Settings tab.
  3. Turn on Manage settings from the server. When this is off, the role doesn't change any client settings.
  4. Select Edit on the group you want to change, update the settings, and select Done.
  5. Select Save Settings.

Users get the new settings the next time their client connects.

For each on/off setting, choose:

  • Set by client: the server doesn't manage this setting, and the user's own value is used.
  • On or Off: the server sets the value, and the user can't change it.

Text and number settings are left to the client when they are blank.

Available Settings

The settings below match the client connection settings. See Connection Settings for more detail on what each one does.

DNS

SettingDescription
Enable Aliases (DNS Override)Use Pangolin's DNS to resolve internal resources and aliases, overriding the device's default DNS settings.
DNS Over TunnelSend DNS queries through the tunnel for remote resolution. The DNS server must be defined as a Pangolin resource.
Primary Upstream DNS ServerThe DNS server for queries that aren't Pangolin aliases. Must be an IPv4 or IPv6 address.
Secondary Upstream DNS ServerA fallback upstream DNS server. Must be an IPv4 or IPv6 address.
Match DomainsOne wildcard pattern per line, such as *.proxy.internal. Only matching queries go to the upstream DNS servers; everything else uses the device's DNS servers.

The primary and secondary upstream DNS servers are managed together: if you set either one, the client uses only the servers you set.

Exit Node

SettingDescription
Exit NodeA gateway resource to send the client's traffic through. Users must have access to the gateway resource for it to take effect.
Exit Node ModeDefault applies until the user picks a different exit node. Locked always applies, and the user can't change or turn off the exit node.
Exit Node Takes Precedence Over ResourcesDon't add routes or resolve aliases for individual resources, so all traffic is sent through the exit node.

Advanced

SettingDescription
MTUThe MTU of the client's tunnel interface, between 576 and 65535. Every site the client connects to must use the same MTU. See MTU.
Prefer Local RoutesAdd tunnel routes with a high metric so overlapping routes on the local network take precedence.

Changing MTU is advanced and not recommended for most users. If you manage it from the server, make sure every site those users connect to uses the same value.