MacOS Roaming Client Troubleshooting

Article author
Josh Lamb
  • Updated

This guide is for troubleshooting any issues associated with the Roaming Client.

Roaming Client Debugging

Currently, the Mac Roaming Client has Debug Mode enabled by default. To check that Debug Mode is enabled, simply navigate to your Mac config file and set the log level to “Debug”, then restart the Roaming Client!

Mac Config File can be seen by running the following in your terminal application:

cat /Library/Application\ Support/DNSFilter\ Agent/daemon.conf

For the white-labelled version run:

cat /Library/Application\ Support/DNS\ Agent/daemon.conf

You should see level = "debug" under the [log] section. If not, change the level to debug with your favorite text editor and restart the Roaming Client.

While Debug Mode is enabled the Client will produce logs which can be obtained and sent to our support staff (

Logfile Path

For the standard version run:

tail -f /var/log/com.dnsfilter.agent.macos.helper/daemon.log

For the white-labelled version run:

tail -f /var/log/io.netalerts.agent.macos.helper/daemon.log

MacOS Roaming Client Commands

Whitelabel Consideration

If you're running the MSP / whitelabel version of the Roaming Client, replace DNSFilter in the command below with the appropriate prefix.


Manually stop the Roaming Client

sudo launchctl unload /Library/LaunchDaemons/com.dnsfilter.agent.macos.helper.plist

Manually stop the Roaming Client and disable for automatic startup

sudo launchctl unload -w /Library/LaunchDaemons/com.dnsfilter.agent.macos.helper.plist

Manually start the Roaming Client. Even if it is disabled – this re-enables it to automatically start at machine boot

sudo launchctl load -w /Library/LaunchDaemons/com.dnsfilter.agent.macos.helper.plist

Uninstall the Roaming Client

sudo sh /Applications/DNSFilter\

Was this article helpful?

0 out of 1 found this helpful

Have more questions? Submit a request



Article is closed for comments.