How to Install Pi-Hole on Your Synology NAS

How to Install Pi-hole on Your Synology NAS

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. What is a DNS sinkhole? A DNS sinkhole, also known as a sinkhole server, Internet sinkhole, or Blackhole DNS is a DNS server that gives out false information, to prevent the use of a domain name. It is designed for use on embedded devices with network capability, such as the Raspberry Pi, but it can be used on other machines running Linux like Synology NAS and cloud implementations. Pi-Hole has the ability to block traditional website adverts as well as adverts in unconventional places, such as smart TVs and mobile operating system adverts.

I’m not a fan of applications like Pi-hole because Ad blocking software is leading to ‘the slow death of niches’ like my website. Ad blockers are white flagging Google, Amazon, Facebook and other Internet giants, but what about the small and medium publishers whose livelihood depends on ad revenues? Where is the morality in this? Anyway, my blog has no ads. See below my step by step guide on how to install Pi-Hole on your Synology NAS device. If you prefer AdGuard over Pi-Hole read my step by step guide on How to install AdGuard on your Synology NAS using docker.

Note: This guide works perfectly with the latest version of Pi-Hole 5.4 and DSM 7

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

Install Docker via Synology “Package Center”.

Install Docker Synology DSM 7

  • STEP 3

Add Google DNS. Go to Control Panel / Network / General. Check “Manually configure DNS server” and add on Preferred DNS Server: and on Alternative DNS Server: Click Apply. Follow the instructions in the image below.

Pi-hole Synology NAS Set up 1

  • STEP 4

Go to File Station and open the docker folder. Inside the docker folder, create one new folder and name it pihole. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

Pi-hole Synology NAS Set up 2

  • STEP 5

Now create two new folders inside the pihole folder that you created at STEP 4 name one “pihole” and the other “dnsmasq.d“. Follow the instructions in the image below.
Note: Be careful enter only lowercase, not uppercase letters.

Pi-hole Synology NAS Set up 3

  • STEP 6

Go to Control Panel / Task Scheduler / Create / Scheduled Task / User-defined script. Follow the instructions in the image below.

Pi-hole Synology NAS Set up 4

  • STEP 7

Once you click on User-defined script a new window will open. Follow the instructions below:

  1. General: In the Task field type in “Install Pi-hole“. Uncheck “Enabled” option. Select root User.
  2. Schedule: Select Run on the following date then select “Do not repeat“.
  3. Task Settings: Check “Send run details by email“, add your email then copy paste the code below in the Run command area. After that click OK.
docker run -d --name=pihole \
-e WEB_PORT=8080 \
-e WEBPASSWORD=yourpassword \
-e ServerIP= \
-v /volume1/docker/pihole/dnsmasq.d:/etc/dnsmasq.d \
-v /volume1/docker/pihole/pihole:/etc/pihole \
--net=host \
--restart always \

Note: Before you paste the code above in the Run command area, change the value for WEBPASSWORD and add your own password.
: Before you paste the code above in the Run command area, change the value for ServerIP and add your own Synology NAS Local LAN IP.

Pi-hole Synology NAS Set up 5

  • STEP 8

After you click OK on STEP 7 a new warning pop up window will open. Click OK.

Pi-hole Synology NAS Set up 6

  • STEP 9

After you click OK on STEP 8, select your “Install Pi-hole” Task then click the “Run” tab. You will be asked to run Install Pi-hole – click Yes. Follow the instructions in the image below.

Pi-hole Synology NAS Set up 7

  • STEP 10

Go back to STEP 1 or you will deal with karma 🙂

  • STEP 11

The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser and type in http://Synology-ip-address:8080/admin/

Pi hole Synology NAS Set up 8

  • STEP 12

On the left Pi-hole sidebar click Login. Type in the password you have previously created at STEP 7. Click Log in. Follow the instructions in the image below.

Pi hole Synology NAS Set up 9

Enjoy your Pi-hole! Set it up according to your preference.

Pi hole Synology NAS Set up 10

If you have Portainer installed on your Synology NAS you can also see the Pi-hole container perfectly running with the healthy status.

Pi-hole Synology NAS Set up 11

That’s it! I hope this little guide helps you install Pi-hole on your Synology NAS.

Note: Many content providers (like YouTube / Reddit / Twitch / Spotify / Pandora / Facebook / Hulu) now stream/serve ads from the same servers as the content (meaning if you attempt to block the ads using a Pi-Hole you will also block the content).
Note: If you experience connections problems remember to set your Synology Firewall in Control Panel / Security / Firewall / Edit Rules / Create Firewall Rules and allow Custom Port 53 Protocol All.
Note: Mandatory is to upgrade your Synology NAS RAM memory. Why do you need more RAM? To be more responsive! You will not use Synology NAS just for Docker. Pi-hole needs a minimum of 512 MB of RAM (I repeat, a minimum and that’s just for Pi-hole). If anyone wants to stay within the strict minimum RAM, they are welcome to, but their system will never be as responsive as those which have more RAM installed.
Note: How to Free Disk Space on Your NAS if You Run Docker.
Note: Some people may have problems launching Pi-Hole via Docker. This may be because of different settings in your Synology NAS and router. Every user has their own router settings etc. It’s really hard to troubleshoot the problem. You can also contact me via email and I will try to find a personalized solution for you.
Note: After installing Pi-hole (through Docker), Synology NAS drives are not hibernating at all. The best solution is to Disable Hibernation. This will be easier and much more beneficial overall for everything Pi-hole needs to read database of filters.
Note: Find out how to update Pi-Hole container with the latest image.
Note: If someone have a problem once installation is completed, and get an error “This site can’t be reached” open the Pi-hole GUI and go to Settings / DNS tab and in “Interface listening behavior” option change to Listen on all interfaces, instead of Listen only on interface eth0. (Reported by jtd).
Note: If your Pi-hole container keeps disconnecting uninstall the Synology Package named “DNS Server” which will conflict with Pi-hole on port 53 and don’t let your Pi-hole start.
Note: How can I make Pi-Hole work over VPN connection? Go to Pi-Hole Preferences then check “Listen on all interfaces, permit all origins” on “Interface listening behavior”. Follow the instructions in the image below:

Pi-Hole over VPN connections
Note: Can I run Docker on my Synology NAS? See the supported models.
Note: At STEP 7 you can also change the value variable for the: WEB_PORT – 8080 to 1010 or whatever you want.

This post was updated on Tuesday / September 14th, 2021 at 12:38 PM