Skip to main content

SafeDNS Agent for Windows Setup (beta)

What is Agent created for

The Agent software is designed to automatically launch and manage the SafeDNS web filtering service on Windows-based computers. The Agent should be installed on the PC when you have a private (local) or a dynamic public address, or you want to have a separate web filtering policy for each Windows-based computer within your network.

Attention! If you want to configure the SafeDNS web filtering service for the entire network, you can find information about the available settings in the Instructions section of our website.

Agent Installation

  1. Log into your SafeDNS account using your email/login and password.
    If you have already downloaded the Agent, skip to "Getting Started with Agent".
  2. Navigate to Main, scroll down, and click the "beta release" button under "Windows".

    Screenshot 2023-09-16 002229.png

Make sure your current Windows user account has Administrator rights. Run the SafeDNS-Agent-Setup.exe file and install the Agent on your computer. 

You will see the warning about SafeDNS Certificate installation, please click Next.

Screenshot 2023-09-16 003926.png
Screenshot 2023-09-16 004501.png

Screenshot 2023-09-16 004534.png

Agent Unattended Installation

You can install the Agent in an unattended automatic way. This allows you to automatically install and launch the service, manage the filtering policies, and collect web traffic statistics on several individual computers within your network. Learn how to install the Agent in unattended mode.

Getting Started with Agent

1. Log in to the Agent using your SafeDNS email/login and password.
If you forgot your password, click this link to reset your password:

Screenshot 2023-09-16 005446.png

2. Set up the security PIN that will be used later to restrict access to the Agent.

Screenshot 2023-09-16 005612.png

3. Enter the PIN once again to sign in to the Agent.

Screenshot 2023-09-16 005638.png

Agent overview

1. In the main window of the Agent you can view your account information, current IP address, your Billing Plan, and the Subscription expiration date.
All filtering rules changes can be made in the SafeDNS Dashboard.


Use the Policy menu to view and change the current filtering Policy.

Filtering can be stopped in Agent using the "Filtering enabled" button at the right top corner of the app.

Please note that settings take 5-7 minutes to apply.
In some cases, you will need to clear the cache of your browser.

Screenshot 2023-09-16 005915.png

2. The system information menu shows brief information about the Agent, current filtering policies, and network interfaces. The information in this menu can be copied to the clipboard by clicking the "Copy to clipboard" button.

Screenshot 2023-09-16 010213.png

3. The Debug menu displays the results of the diagnostic commands required for troubleshooting. To send the debug information to SafeDNS, click the "Send report" button.

Screenshot 2023-09-16 014107.png

Additional settings

To ensure the Agent was installed correctly, please navigate to the "Settings" tab in the SafeDNS Dashboard and scroll to the bottom.


If you see the record with the Device name and your IP address, it means that the filtering is working.

Screenshot 2023-09-16 011143.png

After that, you can adjust the filtering Policy according to your needs. You can select categories to block in the SafeDNS Dashboard under the Categories tab.

Screenshot 2023-09-16 011303.png

Don't forget to click the "Save changes" button.

The setup is finished!
A blocked website will display an error message that the Access is closed.


If the filtering doesn't work according to your policy settings, clear the cache of your browser using this guide.

Please note, that settings take 5-7 minutes to apply
Stats and filtering status update hourly



To uninstall the Agent please quit it first. 

Screenshot 2023-09-16 015841.png

Then click Start, type Control Panel, and open it.Screenshot 2023-09-16 020130111.png

Select Category in View by dropdown menu. 

Screenshot 2023-09-16 020557.png

All settings in the Control Panel will be divided into categories. Click Uninstall a program.

Screenshot 2023-09-16 0205571.png

Find SafeDNS Agent in the list of all programs, click it once, and click Uninstall 

Screenshot 2023-09-16 020830.png

Click Yes in appeared window of deletion confirmation
Screenshot 2023-09-16 021205.png

If the User Account Control window appears and asks "Do you want to allow this app to make changes to your device?', then click Yes 
Screenshot 2023-09-16 021139.png

Click OK and the SafeDNS agent will be successfully uninstalled. 
Screenshot 2023-09-16 021237.png