1. Install a supported operating system

You can run Pi-hole in a container, or deploy it directly to a supported operating system via our automated installer.

2. Install Pi-hole

Our intelligent, automated installer asks you a few questions and then sets everything up for you. Once complete, move onto step 3.

Install Pi-hole

Das Einfachste bei Containern ist in meinen Augen immer mit einer docker-compose.yaml Datei zu arbeiten.

Da stehen dann alle nötigen Informationen zu dem Container drin.

# More info at https://github.com/pi-hole/docker-pi-hole/ and https://docs.pi-hole.net/

services:

pihole:

container_name: pihole

image: pihole/pihole:latest

# For DHCP it is recommended to remove these ports and instead add: network_mode: "host"

ports:

- "53:53/tcp"

- "53:53/udp"

- "67:67/udp" # Only required if you are using Pi-hole as your DHCP server

- "80:80/tcp"

environment:

TZ: 'Europe/Berlin'

# WEBPASSWORD: 'set a secure password here or it will be random'

# Volumes store your data between container upgrades

volumes:

- './etc-pihole:/etc/pihole'

- './etc-dnsmasq.d:/etc/dnsmasq.d'

# https://github.com/pi-hole/docker-pi-hole#note-on-capabilities

cap_add:

- NET_ADMIN # Required if you are using Pi-hole as your DHCP server, else not needed

restart: unless-stopped

Run docker compose up -d to build and start pi-hole (Syntax may be docker-compose on older systems)
Use the Pi-hole web UI to change the DNS settings Interface listening behavior to "Listen on all interfaces, permit all origins", if using Docker's default bridge network setting. (This can also be achieved by setting the environment variable DNSMASQ_LISTENING to all)

3. Use Pi-hole as your DNS server

Configure your router’s DHCP options to force clients to use Pi-hole as their DNS server, or manually configure each device to use the Pi-hole as their DNS server.

Use Pi-hole as your DNS server