# SafeDNS Agent for Windows Setup

<p class="callout info">The Agent is available on the following billing plans: **Safe Family, Pro, Pro Plus,** and archived **Safe@Home, Safe@Office**.</p>

---

#### 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](https://www.safedns.com/resource/setup-guides) of our website.

---

#### Agent Installation

1. Log into your SafeDNS account using your email/login and password.  
    If you have already downloaded the Agent, make sure you are using the latest version and go to "[Getting Started with Agent](https://docs.safedns.com/books/installation-guides/page/safedns-agent-for-windows-setup-beta#bkmrk-getting-started-with)".
2. Navigate to Main, scroll down, and click the "beta release" button under "Windows".  
      
    [![1.Agent for Windows.png](https://docs.safedns.com/uploads/images/gallery/2024-08/scaled-1680-/xFPzMe2yqjZMIWzc-1-agent-for-windows.png)](https://docs.safedns.com/uploads/images/gallery/2024-08/xFPzMe2yqjZMIWzc-1-agent-for-windows.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](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/I6s8fSYq9xlHmxmJ-screenshot-2023-09-16-003926.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/I6s8fSYq9xlHmxmJ-screenshot-2023-09-16-003926.png)  
[![Screenshot 2023-09-16 004501.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/HXEl7KTbMUVR3tej-screenshot-2023-09-16-004501.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/HXEl7KTbMUVR3tej-screenshot-2023-09-16-004501.png)

[![Screenshot 2023-09-16 004534.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/tqOC2I7aBDQLeKKv-screenshot-2023-09-16-004534.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/tqOC2I7aBDQLeKKv-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](https://docs.safedns.com/books/installation-guides/page/agent-unattended-installation).

---

#### 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: [https://www.safedns.com/auth/forgot](https://www.safedns.com/auth/forgot)

[![Screenshot 2023-09-16 005446.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/wSoZCJi8FCvxFnAH-screenshot-2023-09-16-005446.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/wSoZCJi8FCvxFnAH-screenshot-2023-09-16-005446.png)

2\. Set up the security PIN that will be used later to restrict access to the Agent.  
The PIN code must be between 4 and 20 characters in length and may consist of digits, letters, or special symbols.

[![Screenshot 2023-09-16 005612.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/POWWLERfYrNB385b-screenshot-2023-09-16-005612.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/POWWLERfYrNB385b-screenshot-2023-09-16-005612.png)

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

[![Screenshot 2023-09-16 005638.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/RZ1ewM1PwSl1EueQ-screenshot-2023-09-16-005638.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/RZ1ewM1PwSl1EueQ-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.](https://safedns.com/cabinet/main/)

<div class="pointer-container" id="bkmrk-%C2%A0"><div class="pointer anim "><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div class="input-group inline block"> <button class="button outline icon" data-clipboard-target="#pointer-url" title="Копировать ссылку" type="button"><svg class="svg-icon" data-icon="copy" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></button></div></div></div>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.

<p class="callout warning">Please note that settings take 5-7 minutes to apply.  
In some cases, you will need to [clear the cache of your browser](https://docs.safedns.com/books/guides/page/how-to-clear-dns-cache).</p>

[![Screenshot 2023-09-16 005915.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/HLGuVgDq2AzWIyaB-screenshot-2023-09-16-005915.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/HLGuVgDq2AzWIyaB-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](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/sgb5J5sjohEXRLBx-screenshot-2023-09-16-010213.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/sgb5J5sjohEXRLBx-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](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/P0qBCEXZtP3pnjag-screenshot-2023-09-16-014107.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/P0qBCEXZtP3pnjag-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](https://www.safedns.com/cabinet/devices) and scroll to the bottom.

<div class="pointer-container" id="bkmrk-%C2%A0-0"><div class="pointer anim "><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div class="input-group inline block"> <button class="button outline icon" data-clipboard-target="#pointer-url" title="Копировать ссылку" type="button"><svg class="svg-icon" data-icon="copy" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></button></div></div></div>If you see the record with the Device name and your IP address, it means that the filtering is working.

[![2.Agent for Windows.png](https://docs.safedns.com/uploads/images/gallery/2024-08/scaled-1680-/tsP5PJ4QIU5UFMoI-2-agent-for-windows.png)](https://docs.safedns.com/uploads/images/gallery/2024-08/tsP5PJ4QIU5UFMoI-2-agent-for-windows.png)

After that, you can adjust the filtering Policy according to your needs. You can select categories to block in the SafeDNS [Dashboard ](https://www.safedns.com/cabinet/main/)under the [Categories](https://www.safedns.com/cabinet/categories) tab.

[![3.Agent for Windows.png](https://docs.safedns.com/uploads/images/gallery/2024-08/scaled-1680-/kgyEGccoXUV79xnn-3-agent-for-windows.png)](https://docs.safedns.com/uploads/images/gallery/2024-08/kgyEGccoXUV79xnn-3-agent-for-windows.png)

<p class="callout info">Don't forget to click the "Save changes" button.</p>

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

[![wPoDDhGm7AwMhbSc-13-safedns-agent-for-macos-setup-guide.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/JcPNSgebraEmPBIf-wpoddhgm7awmhbsc-13-safedns-agent-for-macos-setup-guide.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/JcPNSgebraEmPBIf-wpoddhgm7awmhbsc-13-safedns-agent-for-macos-setup-guide.png)

If the filtering doesn't work according to your policy settings, clear the cache of your browser using this [guide](https://docs.safedns.com/books/installation-guides/page/how-to-clear-dns-cache).

<p class="callout warning">**Please note, that settings take 5-7 minutes to apply**  
**Stats and filtering status update hourly**</p>

#### **Uninstallation**

<div class="pointer-container" id="bkmrk-%C2%A0-1"><div class="pointer anim "><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div class="input-group inline block"> <button class="button outline icon" data-clipboard-target="#pointer-url" title="Копировать ссылку" type="button"><svg class="svg-icon" data-icon="copy" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></button></div></div></div>To uninstall the Agent please quit it first.

[![Screenshot 2023-09-16 015841.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/DDBe9mUO5eLQaPJP-screenshot-2023-09-16-015841.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/DDBe9mUO5eLQaPJP-screenshot-2023-09-16-015841.png)

Then click **Start**, type **Control Panel,** and open it.[![Screenshot 2023-09-16 020130111.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/oE3wOh8Uv8CwqweT-screenshot-2023-09-16-020130111.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/oE3wOh8Uv8CwqweT-screenshot-2023-09-16-020130111.png)

Select **Category** in **View by** dropdown menu.

[![Screenshot 2023-09-16 020557.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/SvVq2amCCW6tTDIb-screenshot-2023-09-16-020557.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/SvVq2amCCW6tTDIb-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](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/0EiscPIeZqNIm3VI-screenshot-2023-09-16-0205571.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/0EiscPIeZqNIm3VI-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](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/4Awz70vIS8adw3Qy-screenshot-2023-09-16-020830.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/4Awz70vIS8adw3Qy-screenshot-2023-09-16-020830.png)

Click **Yes** in appeared window of deletion confirmation  
[![Screenshot 2023-09-16 021205.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/jPcSAp8szF6TpTgE-screenshot-2023-09-16-021205.png)](https://docs.safedns.com/uploads/images/gallery/2023-09/jPcSAp8szF6TpTgE-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](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/Nod4FUkOh1DTiEYC-screenshot-2023-09-16-021139.png)

Click **OK** and the SafeDNS agent will be successfully uninstalled.   
![Screenshot 2023-09-16 021237.png](https://docs.safedns.com/uploads/images/gallery/2023-09/scaled-1680-/8wvKLo8RkiWookPw-screenshot-2023-09-16-021237.png)