How to Install Pi-Hole on OpenMediaVault 5 inside Docker with Portainer using Raspberry Pi 4

In this segment, we are going to show you how to configure “Pi-Hole on Docker with Portainer using OpenMediaVault 5 Raspberry Pi 4 “

What is Pi-Hole?

Pi-hole is a free and open-source network-wide adblocker. This allows traffic to pass through its DNS server and block the predefined queries from the internet. It is based on  Linux network-level advertisement and Internet tracker blocking the application.

OpenMediaVault Versions :

Software Required :

• SD Card Formatter
• Etcher
• Putty
• Wireless Network Watcher

Equipment Required		Optional
	Raspberry Pi 4		Case
	SD Card		Raspberry Pi Keyboard
	Ethernet Cable		Mouse
	Power Adapter
	External HDD
Shop now

We may earn a commission for purchases using our links. Learn more.

Checkout official website: pi-hole

Docker-compose

version: "3"

# 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
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "67:67/udp"
      - "80:80/tcp"
      - "443:443/tcp"
    environment:
      TZ: 'Asia/Kolkata'
      # 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/'
    dns:
      - 127.0.0.1
      - 1.1.1.1
    # Recommended but not required (DHCP needs NET_ADMIN)
    #   https://github.com/pi-hole/docker-pi-hole#note-on-capabilities
    cap_add:
      - NET_ADMIN
    restart: unless-stopped

Note: Please change the OMV default port from 80 to something else and then start with

sudo apt update
sudo apt dist-upgrade

Configuring Openmediavault Network Interface

• First, we need to configure our DNS servers from Openmediavault Network Interface. Here we need to navigate to Network –> Interfaces and edit the Network.
• However, we need to configure the DNS Server from Advanced settings to 127.0.0.1 or 1.1.1.1 as shown in Pi-Hole Docker-compose.

Create Macvlan Network for Pi-Hole

• Once the DNS is successfully configured then we need to open Putty and login to our OpenMediaVault with root user.
• After that, enter the below-given command to create Macvlan network for Pi-Hole. Remember to change the subnet to your OpenMediaVault IP Address.

docker network create -d macvlan \
    --subnet=192.168.1.10/24 \
    --gateway=192.168.1.1 \
    -o parent=eth0 pub_net

Configure Pi-Hole container

sudo systemctl disable systemd-resolved.service
sudo systemctl stop systemd-resolved

Network: Select the Macvlan network that we have created 
Hostname: Create a Host Name for your Pi-Hole 
IPv4 Address: Type an IP Address for your Pi-Hole
Primary DNS: 127.0.0.1
Secondary DNS: 1.1.1.1

ServerIP : "Type the Pi-Hole IP Address, which we created" 
TZ: "Asia/kolkata", Type your Time Zone 
WEBPASSWORD : "Password of your choice"

• Finally, once everything is done we can go ahead and click on Deploy the container.

Access Pi-Hole Server Web Interface

• To access the Pi-Hole web interface we need to type the Pi-Hole IP Address/admin.
• However, our Pi-Hole is not yet ready for blocking Ads on our Network. We need to update Pi-Hole IP Address to our Router DNS.

http://Pi-Hole IP Address/admin/

Updating Pi-Hole IP Address to Router DNS

• At this moment we need to log in to our Router, then Navigate to DNS Settings.
• After that, we need to enter the Pi-Hole IP Address to our Router Primary DNS Address.
• Finally, all the traffic will route through the Raspberry Pi and Block ads with Pi-Hole.

Primary DNS Address   : "Pi-Hole IP Address"
Secondary DNS Address : "Cloudflare DNS Address i.e 1.1.1.1"

Reset Pi-Hole Password

• If you forgot the Pi-Hole password you can reset it anytime by using this command inside Terminal.

docker exec -it pihole pihole -a -p

In conclusion

• Above all steps will convert your Raspberry Pi 4 as Pi-Hole Network Wide Ad-Block Server.
• If you face any issue regarding this article please share your thoughts.
• Enjoy using Pi-Hole on Docker using Openmediavault. Smile (.”_”.)

Please check out my other articles:

• How to install OpenMediaVault 5 on Raspberry Pi All Models 
• OpenMediaVault 5 NAS Server on Raspberry Pi 4

Did you find us helpful?

Subscribe our YouTube Channel
Support us on Patreon
Like us on Facebook
Share This Article with others