Roaming Client Troubleshooting
Articles to troubleshoot issues with Roaming Client connectivity and settings.
-
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... -
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 macOS Roaming Client. Send the log files to our Support team for review. Before contacting our Support team Review ou... -
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%... -
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... -
DNS PreCheck Known Limitations
Network and endpoint administrators use this page to understand current limitations of DNS PreCheck in the Windows Roaming Client and how these behaviors may affect filtering, logging, and DNS rout... -
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... -
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... -
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 ... -
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... -
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... -
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... -
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...