Docker Pi-hole (Personal Fork)

Network-wide ad blocking via your own Linux hardware

Pi-hole website | Documentation | Discourse Forum | Donate

Why this fork?

This repository is a personal minimal fork designed to keep things as simple as possible for running Pi-hole as a local DNS blocker.

Requirements

You need a computer with a static IP that will act as the DNS server for your network. The machine requires:

• docker
• docker-compose

Configuration

Clone the repository:

git clone https://github.com/pumukydev/docker-pi-hole.git
cd docker-pi-hole

Edit the docker-compose.yml file and set your own admin password (used for the web interface):

...
FTLCONF_webserver_api_password: 'changeme'
...

Then start the container.

docker compose up -d --build

Access the web interface at http://YOUR-HOST-IP:8005/admin

Here you can configure and monitor your Pi-hole installation.

Finally, make sure to set your device's IP as the primary DNS server in your router's network settings.

That's it! Now your entire network will be filtered and ads will be blocked automatically.