Installing the Protect Agent on Linux as a Systemd service

1. Download the  zip package from

2. Create the directories /opt/p8dns agent

3. Extract it into /opt/p8dns agent

4. On the command line:

cd /opt/p8dns agent
sudo chmod +x bin/*.sh
sudo cp script/p8dns.service /lib/systemd/system/p8dns.service
sudo systemctl enable p8dns.service
sudo systemctl start p8dns.service

To stop the command - sudo systemctl stop p8dns.service

*Requires the latest version of Java to run.

How to configure Protect Agent

To set up the Protect Agent, you will need to configure the file.

Linux = /opt/P8DNS Agent/conf/

The file contains the following:

server =

token = BSYEB28O

local_dns =;

local_domain =

Variable meanings:

This is the Protect IPs of /
This is your User token configured in Protect (This links your Protect to the Protect Agent)
This is the local DNS servers
This is the local domain if the Agent is running a windows server


When you run the Protect Agent as the DNS server for your network, it starts filtering with the policy associated with the login token you set up in the config file.

You can add a User's token which can be created under Protect console>Users

For a single site, use the default user's token which needs to be created.

For multiple sites, add each user (sites), token to each relevant site.