README.md

Services: Pi-Hole

Index

• Summary
• Requirements
• How to use Pi-Hole DNS Server on your routers
• Access the Pi-hole dashboard
• Documentations

Summary

This deployment will set up Pi-Hole.

Pi-hole is a Linux network-level advertisement and Internet tracker blocking application which acts as a DNS sinkhole and optionally a DHCP server, intended for use on a private network

Requirements

1. This deployment depends on nfs-server deployment.

Update the file deploy-pihole.yml.j2, line 117, with your Timezone.

- name: TZ
  value: "Australia/Brisbane"

Update the file secret-pihole.yml.j2, line 8, with preferred password.

data:
  webpwd: "abc" # echo -n "original-key" | base64

How to use Pi-Hole DNS Server on your routers

On your router, you've to set the DNS primary server to the Pi-hole IP address.

example: How to use Pi-Hole DNS Server on TP-Link routers

Access the Pi-hole dashboard

Open the web broswer and go to http://ip_node_01:8000/admin, where the ip_node_01 is the IP Address setup in the file deploy.pihole.yml.j2 line 161

Click on log-in and enter your password. You should now be in the Pi-hole admin panel

Documentations

Install

Post-Install

Avoid The Hack: The Best Pi-Hole Blocklists (2023)