In this article

These commands can be useful during initial deployment, troubleshooting issues, scripting, or getting some help from our Support team.  

If you're here looking for troubleshooting tools, start with the macOS Roaming Client issue diagnostics article to run the Diagnostic Tool. 

Silent Install macOS Roaming Client

Completes a silent install. This command requires the .pkg file is already installed on the machine. Note to replace "your site key here" before running the command. 

• #!/bin/bash curl https://download.dnsfilter.com/User_Agent/MacOS/DNSFilter%20Agent-Installer.pkg -o /tmp/DNSFilter%20Agent-Installer.pkg cd /tmp echo "your site key here" > dns_agent_site_key && sudo installer -dumplog -store -pkg DNSFilter%20Agent-Installer.pkg -target /

• #!/bin/bash curl https://download.dnsfilter.com/User_Agent/MacOS/DNS%20Agent-Installer.pkg -o /tmp/DNS%20Agent-Installer.pkg cd /tmp echo "your site key here" > dns_agent_site_key && sudo installer -dumplog -store -pkg DNS%20Agent-Installer.pkg -target /

Stop/Start macOS Roaming Client

These advanced commands are useful if the agent needs quickly stopped/started instead of rebooting the machine. 

Manually stop Roaming Client

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

• sudo launchctl unload /Library/LaunchDaemons/io.netalerts.agent.macos.helper.plist

Manually stop Roaming Client and disable for automatic startup

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

• sudo launchctl unload -w /Library/LaunchDaemons/io.netalerts.agent.macos.helper.plist

Manually start the Roaming Client

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

• sudo launchctl load -w /Library/LaunchDaemons/io.netalerts.agent.macos.helper.plist

Unistall macOS Roaming Client

Run to uninstall the macOS Roaming Client

• sudo sh "/Applications/DNSFilter Agent.app/Contents/Resources/uninstall.sh"

• sudo sh "/Applications/DNS Agent.app/Contents/Resources/uninstall.sh"

To confirm the agent is uninstalled:

• yes | sudo sh "/Applications/DNSFilter Agent.app/Contents/Resources/uninstall.sh"

• yes | sudo sh "/Applications/DNS Agent.app/Contents/Resources/uninstall.sh"

Port Binding

Determines what other applications might be listening or bound to port 53--the port the agent needs to bind to for filtering. 

sudo lsof -i -P | grep LISTEN | grep :53