RUN SAP BETTER

Pi Hole (DNS Sinkhole)

Installing Pi Hole o n Ubuntu

​

• Open the terminal

• For non-root users, use the command "sudo" to perform administrative tasks​

• Update Package Database | Command: apt update

• Install 'curl' to download the Application | Command: apt install curl

• Install Pi-Hole | Command: curl -sSL https://install.pi-hole.net | bash

• Follow the steps to conclude the installation

• Pi-Hole will be installed and the initial password will be displayed on the screen

• Changing the Initial Password | Command: pihole -a -p

​

Installing Pi Hole on Docker Container

​

PowerShell Command:

​​

• Open the terminal

• For non-root users, use the command "sudo" to perform administrative tasks​

• Install Pi-Hole | Command: docker run -d --name pihole -p 53:53/tcp -p 53:53/udp -p 80:80 -p 443:443 -e TZ="Europe/London" -v "$(pwd)/etc-pihole/:/etc/pihole/" -v "$(pwd)/etc-dnsmasq.d/:/etc/dnsmasq.d/" --restart=unless-stopped pihole/pihole:latest

• docker run -d (Run Docker)

• --name pihole (Container Name)

• -p 53:53/tcp (Ports to expose. The 53 and 80 are the bare minimum ports required for Pi-holes HTTP and DNS services)

• -p 53:53/udp

• -p 80:80

• -p 443:443

• -e TZ="Europe/London" (Timezone)

• -v "$(pwd)/etc-pihole/:/etc/pihole/" (Volume  and $(pwd) for your Pi-hole configs help persist changes across docker image updates)

• -v "$(pwd)/etc-dnsmasq.d/:/etc/dnsmasq.d/" (Volume  and $(pwd) for your Pi-hole configs help persist changes across docker image updates)

• --restart=unless-stopped (Automatically (re)start your Pi-hole on boot or in the event of a crash)

• pihole/pihole:latest (Image of the Pi Hole and the tag latest  to always get the latest release)

​

Automatic Ad List Updates: Since the 3.0+ release, "cron" is baked into the container and will grab the newest versions of your lists and flush your logs. Set your TZ environment variable to make sure the midnight log rotation syncs up with your timezone's midnight.

​

Accessing the Pi Hole

​

URL: http://pi.hole/admin

​

If the URL doesn't work you can check the "IPCONFIG" Command Prompt, the IPv4 of your LAN (main server)

​

Example: 192.168.0.101/admin

​

Initial Password

​

Since we didn't use the variable to set the password, Pi Hole generates a random one.

Check the password:

• Open your Docker Container

• Containers

• Click on Pi Hole Container

• Logs tab

• Search for assigned random password

  • Line example: [i] Assigning random password: 5Tg45Gd9

​

Changing the Password:

• You don't need the initial password to change it

• Just need to type the command: docker exec -it <pihole_container_name> pihole -a -p (in our case the name is pihole)

• And a prompt will request the new password

​

Command:

​

docker exec -it pihole pihole -a -p

​

Using the Pi Hole

​

You can use the same IP address that you are using to access the Pi Hole Web GUI to put as a DNS in your laptop, mobile or pfSense.

AdGuard Home (DNS Sinkhole)

​

What is AdGuard Home?

​

It is a DNS Resolver and DNS Sinkhole. In other words, AdGuard Home is a application for blocking ads & tracking.

​

It will replace the IP of your DNS server, querying major DNS providers such as Google (8.8.8.8), Cloudflare (1.1.1.1), with the correct IP address for your devices (DNS Resolver). But with one difference, it will block ads and tracking IPs by changing it to (0.0.0.0), a non-existent IP address (DNS Sinkhole).

​

Benefits

• Privacy (Tracking Blocking)

• Reduction of Ads

• Increasing network speed (IP 0.0.0.0 won't download anything)

​

Installing on Docker

​

Warning: According with AdGuard documentation, the application has no drivers to work on Windows Docker, it must be installed on Docker on Linux-based system.

​

Pull the Docker Image

​

docker pull adguard/adguardhome

​

Create and Run the Container

​

docker run --name adguardhome --restart unless-stopped -v /my/own/workdir:/opt/adguardhome/work -v /my/own/confdir:/opt/adguardhome/conf -p 53:53/tcp -p 53:53/udp -p 67:67/udp -p 68:68/udp -p 80:80/tcp -p 443:443/tcp -p 443:443/udp -p 3000:3000/tcp -p 853:853/tcp -p 784:784/udp -p 853:853/udp -p 8853:8853/udp -p 5443:5443/tcp -p 5443:5443/udp -d adguard/adguardhome

​

• docker run --name adguardhome

• --restart unless-stopped

• -v /my/own/workdir:/opt/adguardhome/work

• -v /my/own/confdir:/opt/adguardhome/conf

• -p 53:53/tcp -p 53:53/udp

• -p 67:67/udp -p 68:68/udp

• -p 80:80/tcp -p 443:443/tcp -p 443:443/udp -p 3000:3000/tcp

• -p 853:853/tcp

• -p 784:784/udp -p 853:853/udp -p 8853:8853/udp

• -p 5443:5443/tcp -p 5443:5443/udp

• -d adguard/adguardhome

​

Installing on Linux-based Systems (Ubuntu, Raspberry Pi OS)

​

1 Option using "curl"

​​

• Open the terminal

• For non-root users, use the command "sudo" to perform administrative tasks​

• Update Package Database | Command: apt update

• (Optional) If you don't have "curl", install it | Command: apt install curl

  • Verify if you have "curl" | Command: curl --version

• Install AdGuard | Command: curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

• Accessing AdGuard

  • Finishing the installation you will see the IP address to access the Web GUI. (It will be the IP address with port 3000)

  • Example: http://127.0.0.1:3000

​

2 Option using "snapd"

​​

• Open the terminal

• For non-root users, use the command "sudo" to perform administrative tasks​

• Update Repository | Command: apt update

• (Optional) If you don't have "snap", install it | Command: apt install snapd

  • Verify if you have "snap" | Command: snapd --version

• Install AdGuard | Command: snap install adguard-home

• Accessing AdGuard

  • Finishing the installation you will see the IP address to access the Web GUI. (It will be the IP address with port 3000)

  • Example: http://127.0.0.1:3000