Roaming Client Troubleshooting
Articles to troubleshoot issues with Roaming Client connectivity and settings.
-
Airplane and hotel Wi-Fi login page not loading on macOS
Use this article to enable and configure Travel Wi-Fi mode for macOS Roaming Clients, a feature introduced in version 2.3.8 of the macOS agent that helps macOS devices load captive portals on netwo... -
Internet connectivity lost when updating macOS Roaming Client 1.x.x to 2.x.x
In certain cases, updating the macOS Roaming Client from v1.x.x to v2.x.x may not restore the original DNS settings upon uninstall, leaving the DNSFilter IP 127.0.0.1 (loopback address) as the devi... -
Public Wi-Fi Captive Portal connection issues
This article explains how the DNSFilter Roaming Client works with captive portals (e.g., airport, hotel, or coffee shop Wi-Fi login pages) and provides troubleshooting tips if the portal doesn’t lo... -
Captive Portal detection issue in macOS Roaming Client 2.2.0
In macOS Roaming Client 2.2.0, captive portal login pages (e.g., on airplanes, in hotels, or cafés) may not appear when connecting to networks that require web-based authentication. This occurs whe... -
Download Windows Roaming Client log files
This article covers how to download log files to troubleshoot issues associated with the Windows Roaming Client. Send the files to our Support team for review if you are unable to identify the reso... -
Download macOS Roaming Client log files
Use this guide to download log files to troubleshoot issues associated with the Roaming Client for macOS. Send the log files to our Support team for review. Diagnostic Tool macOS Roaming Client 1.6... -
Prevent VPN-related Windows Roaming Client conflicts
This article explains how to configure remote access VPNs (e.g., Palo Alto, SonicWall, AnyConnect, OpenVPN) to work smoothly with the Windows Roaming Client. When both are running, Windows may rout... -
Resolve Roaming Client issues by reviewing agent diagnostic logs
This article helps to diagnose and resolve Roaming Client issues using diagnostic logs. Most of these issues can also be diagnosed without access to the log files; alternative methods are listed we... -
Local DNS resolution failing while using Roaming Clients
If local DNS resolution is failing, a possible cause is that either EDNS isn't supported or a firewall is blocking EDNS queries.Windows deploymentsBeginning with Windows Roaming Client 1.11.0, EDNS... -
Windows Roaming Client restarts service when intentionally stopped
The DNSFilter Roaming Client version 2.1.0 or higher includes a Service Manager that monitors the agent and automatically restarts it if it stops, unless the Service Manager is also stopped.This is... -
Windows Roaming Client offline at startup
Starting with version 2.0.1 of the Windows Roaming Client, network administrators can run a sleep study to streamline troubleshooting with Support. What is a sleep study? A sleep study is a diagnos... -
Why Roaming Clients may not auto-update
If Roaming Clients have auto-updates enabled but are not auto-updating, there may be a few different causes. This article outlines known issues and troubleshooting steps.Auto-updates aren't at 100%... -
Windows Roaming Clients 1.11.0 and 1.12.0 will not auto-update
Branded Windows Roaming Client versions 1.11.0 and 1.12.0 fail to auto-update to newer versions. The non-branded (whitelabel) agent is not affected. We also updated our testing process to prevent s... -
Limited Connectivity indicator when using Windows Roaming Client
Use this article to troubleshoot DNSFilter or network settings if the Windows Network Connectivity Status Indicator (NCSI) displays a limited network connection notification after installing the Wi... -
Resolve Zero Trust VPN conflicts with the Windows Roaming Client
This article explains how to restore DNS resolution while remaining protected by DNSFilter using a Windows NRPT (Name Resolution Policy Table) rule.Zero trust VPNs—such as Ivanti, ZScaler, Cloudfla... -
Microsoft Entra GSA and Windows Roaming Client
When using Microsoft Entra Global Secure Access (GSA) alongside the DNSFilter Windows Roaming Client, users may see domain resolution failures in certain environments.Common causes include: GSA doe... -
Webex compatibility with Windows Roaming Client
When using Webex with the DNSFilter Windows Roaming Client, users may experience connectivity failures. This occurs because Webex sometimes relies on older NAPTR records that the Roaming Client can... -
macOS Roaming Client not auto-updating on OS 15 Sequoia
What we know After the release of Apple's operating system Sequoia (macOS 15), DNSFilter started receiving notifications from users that have updated their OS that the agent no longer auto-updates ... -
End-user prompts still appear during macOS v2.2.0 installation
This article explains how to resolve unexpected end-user prompts that may appear during installation of the DNSFilter macOS Roaming Client version 2.2.0 or higher. This guidance applies only to ver... -
VPN, EDR, and firewall compatibility issues with macOS Roaming Client v2.2.0+
The macOS Roaming Client (v2.2.0 and higher) uses Apple’s System Extensions framework for secure, system-wide DNS interception. While this improves stability and security, it also means that VPN cl... -
Capture diagnostic logs when the macOS agent v2.2.0+ is offline
Follow these steps to collect diagnostic logs from the DNSFilter macOS Roaming Client v2.2.0 or higher when it is in an “Offline” state. Capturing diagnostic logs helps Support investigate and reso... -
macOS Roaming Client offline after installation
The macOS Roaming Client may appear offline or not activate after installation, which means DNS traffic isn't filtering through DNSFilter.This article outlines the symptoms, possible causes, and re... -
macOS Security Features, Connectivity Impact & Troubleshooting
macOS includes several built-in security features that help protect devices and user data. In some cases, these settings can also interfere with network connectivity, either by design or due to mis...