Skip to main content

SafeDNS Agent for Linux Setup

Installation requirements: Debian 9, Ubuntu 18–22, PopOS, CentOS 7.
The Agent is available on the following billing plans: Safe Family, Pro, Pro Plus, and archived Safe@Home, Safe@Office.

Getting Started

1. Log in to your SafeDNS account with your registration email and password.

2. Navigate to the Getting Started tab on the main page of the Dashboard and select the Linux button. Choose and download the needed package: .rpm or .deb.

1. Agent for Linux.png

.rpm package

Use the following command for the installation from the Terminal app:

sudo rpm -Uvh /home/user/Downloads/safedns-agent-1.3.1-x86_64.rpm

Please note, that the path to the file and/or package name might be different.

.deb package

For experienced users. You can use this command to install from the Terminal app:

sudo dpkg -i /home/user/Downloads/safedns-agent-1.3.1-x86_64.deb

Please note, that the path to the file and/or package name might be different.


1. Open the “Downloads” folder:

2.SafeDNS Agent for Linux Setup Guide.png

2. Run the downloaded file and install the Agent. Enter the Admin password if prompted.

3.SafeDNS Agent for Linux Setup Guide.png

3. You will see the following window once the installation finishes:

4.SafeDNS Agent for Linux Setup Guide.png

Agent Setup

1. Restart your system. The Agent icon will appear in the system tray.

2. Open the Agent by clicking on the icon in the system tray.

5.SafeDNS Agent for Linux Setup Guide.png

!On Debian 9, click on the black line in the bottom right corner, if the tray icon is hidden.

6.SafeDNS Agent for Linux Setup Guide.png

3. Enter your SafeDNS account credentials in the opened window.

7.SafeDNS Agent for Linux Setup Guide.png

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

8.SafeDNS Agent for Linux Setup Guide.png

5. Enter the PIN once again to sign in to the Agent:

9.SafeDNS Agent for Linux Setup Guide.png

Agent Overview

The main window of the Agent. Here you can view your account information, current IP address, your Billing Plan, and Subscription expiration date.

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

10.SafeDNS Agent for Linux Setup Guide.png

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

11.SafeDNS Agent for Linux Setup Guide.png

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

12.SafeDNS Agent for Linux Setup Guide.png

Additional settings

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

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

2. Agent for Linux.png

After that, you can adjust the filtering Policy according to your needs. You can select categories to block here.
Don't forget to click the "Save changes" button.

3. Agent for Linux.png

The setup is complete!

A blocked website will display an error message that the Access is closed:

15.SafeDNS Agent for Linux Setup Guide.png

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

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

Uninstallation

For the .rpm package, use the following command:

sudo rpm -e agentsafedns

For the .deb package, use the following command:

sudo apt-get remove agentsafedns

 

Enter "y" if prompted to confirm the Agent removal.

Back to top