Arjun.bond

Docker – DNS filtering

Written by

Arjun

in

In this Tutorial I will show you how to set up Portainer, and then how to set up DNS filtering!

Getting Started

  1. Install Docker
  2. Connect your computer to the internet with an ethernet cable (optional but highly recommended)
  3. Make sure the power settings for the computer never permit it to sleep as the computer will constantly need to be awake. Mac Windows
  4. Make sure to assign the computer a static ip address (eg 192.168.1.200) Mac Windows

Installing Portainer

Portainer is a free utility that provides a web interface to manage the containers running on that machine and others.

To install portainer you need to go to This page and run the command that it shows. For Mac users you need to select Linux. If you want to you can also install Portainer Business edition, although community edition is sufficient for what we need.

Once installed go to the ip of your computer and go to port 9443 for example ” https://192.168.1.200:9443 ” and set up an account. 

You should then be on the homepage

Setting Up AdguardHome DNS filtering

Click on local then on Volumes

Then Add two Volumes called Adguard_Data and Adguard_Config  

Once this has been done go to Containers and Create a new container. You should now be on this page

Then Name the container Whatever you want (I called it AdguardHome) and set the image to: adguard/adguardhome:latest

After doing this you will need to publish some ports for the service to work , these ports are:
TCP port 53 to port 53 on the Container

TCP Port 80 to port 80 on the Container

TCP port 3000 to port 3000 on the container 

UDP port 53 to port 53 on the container

You should now have something like this:

Now you need to map the volumes that you set up earlier, set them as the following (all as volumes and writeable)

/opt/adguradhome/work –> Adguard_Data – local 

/opt.adguardhome/conf –> Adguard_Config – local

Now you should have something like this! 

Finally set the restart policy to Unless Stopped and you are ready to deploy the container

Then Click Deploy to deploy the container – this may take a while

After the Container is deployed go to the static ip :3000 for example http://192.168.1.200:3000.  This will bring you to a setup screen.

Now all you need to do is to set the DNS server target the Static IP you set not 127.0.0.1 or 172.17.0.1

For Feedback –  Google Forms

if you have any issues contact me at [email protected]

More posts