Installing the P8DNS 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 P8DNS Agent

To set up the P8DNS 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 P8DNS IPs of /
This is your User token configured in P8DNS (This links your P8DNS to the P8DNS Agent)
This is the local DNS servers
This is the local domain if the Agent is running a windows server

Which P8DNS policy to apply

When you run the P8DNS 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 P8DNS 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.