How To Setup Pi-hole On A Synology NAS

Using a Pi-hole on your network is a great way of blocking adverts and protecting you from tracking at a network level. In this post I’m going to take you through setting up Pi-hole on a Synology NAS using Docker.

I’ve been using Pi-hole on my network for a few weeks now and things are going great. I’m sure you can gather than from the name, Pi-hole was originally designed to run on the Raspberry Pi.

But I don’t like the idea of having something as crucial as DNS running on a RPi, so I run Pi-hole on my Synology (I have a DS218+). To get Pi-hole up and running, you could download the image, spin a container with the default settings and it will work.

However, you will end up seeing all the clients on your network bundled under a single 172.x.x.x IP address, which is the Docker gateway IP. This issue on Github talks about the problem in a little more detail.

Ad and tracker blocking will work with the default settings, but to get a true picture of what’s going on with your network, you need to see all the clients separately. So I’ll take you through what settings you need to tweak in order to make this happen.

Setting up Pi-hole on a Synology

Right then, let’s get to work, shall we? The first thing you’re going to need to do is install the Synology Docker app. So launch the Synology Package Centre, search for docker and click on the Install button.

Synology Docker install

Next, launch the Docker app, click on Registry from the left-hand pane and search for pi-hole. You should see the official Pi-hole at the top of the list.

Double-click on the official Pi-hole image to download it to your Synology.

Pi-hole Docker image

Setting up the folders

Now we need to flip to the Synology File Station app. Navigate to the Docker folder and create a new sub-folder called pihole.

Once you have your new pihole folder, create two more folders within it; one called pihole and another called dnsmasq.d. Once done, it should look something like this:

Pi-hole folder structure

Configuring the Docker container

Ok then, back to the Docker app we go. We’ve downloaded the Pi-hole image and we now need to setup the container correctly.

Select the Images tab from the left-hand panel and double-click on the Pi-hole image you downloaded earlier. The container configuration wizard should now launch.

In the first step, give the container a name; I personally went with PiHole, but you can use whatever makes sense to you. Leave Execute container using high privilege unchecked, then click on the Advanced Settings button.

Pi-hole config 01

Once in Advanced Settings, check the box the Enable auto-restart. This will ensure Pi-hole restarts if you ever need to reboot your Synology.

Next, go to the Volume tab and add the two folders you created earlier, mapping them to the following directories:

FolderMount Path

Once you’re done adding the folder mappings, it should look like this:

Pi-hole config 02

Next, go to the Network tab and enable the option to Use the same network as Docker Host.

Pi-hole config 03

The final step is to go to the Environment tab so we can add/change a few environment variables. There are three variables we need to add, and one we need to edit.

Let’s start with the new variables first:


For the WEBPASSWORD variable, set this to whatever you want the Pi-hole login password to be. For WEB_PORT use any port you have available, 8080 should work for most people.

Next we need to edit the ServerIP variable. The default value is You need to change this to your Synology’s internal IP address. For me, this is

Pi-hole config 04

Finally, click on the Apply button and start your shiny new Pi-hole container.

Once it’s up and running, you should be able to navigate to http://<synology-ip>:<pi-hole-port>/admin (for me this would be to access Pi-hole.

Note: This will only be accessible on your local network. I wouldn’t recommend exposing Pi-hole to the Internet.

To login, use the password you created when you added the WEBPASSWORD environment variable. You should now see a dashboard similar to this:

Pi-hole dashboard

Next steps

Now you have Pi-hole up and running on your Synology, you will need to change the DNS settings on your router so that DNS points to your Pi-hole and not your router.

This process all depends on which router you have. So find the DNS/DHCP settings on your router and change the primary DNS server to the IP address of your Synology.

I would also recommend setting the secondary DNS as your router, or a service like Quad 9. So you will still be able to resolve DNS queries if Pi-hole goes down.

Once your client machines start getting new DHCP leases from your router, the DNS changes should take place and you will see the client numbers grow within Pi-hole. To speed up this process, disconnect and reconnect any devices from the network.

Finally, I’d recommend changing the default public DNS servers that Pi-hole uses. Pi-hole uses Google DNS by default and since I’m a de-Googled kinda guy, I don’t like this. Instead I set them to Quad 9.

You can do this by going to Settings > DNS:

Pi-hole DNS settings


You should now be setup with Pi-hole on your Synology NAS. No more ads, no more tracking, and no more ISP monitoring of your DNS. Pretty cool, huh?

In terms of performance impact on your Synology, there will be very little. On my network, the Pi-hole container uses around 30MB of RAM and the CPU usage doesn’t even register. So even if you have a fairly low powered Synology, you should still be fine.

Hosting Pi-hole on the Synology is much more robust than on the Raspberry Pi. While the Pi is great for hacking on, it’s not the right kind of hardware to be used as a server in my opinion.

Finally I’d like to quickly add that if you get use out of your Pi-hole instance, please remember to throw the project a donation. It will really help support this great project and keep it alive.

Subscribe for more!

You will receive monthly emails with updates and previews of upcoming posts. To find out more, click here.

Please enter a valid email address.
That email address is already subscribed.
The security code entered was incorrect
Thanks for signing up!




Please read my commenting guidelines before posting a comment.

  1. When I click on Docker > Launch, to configure pihole, it says that proceeding will give pihole root access privileges in DSM. How do I avoid giving it root access?

  2. Thank you for the clear instructions. I followed them step by step, but my docker won’t start. I get following error : “dnsmasq: failed to create listening socket for port 53: Address already in use”

    1. It means you’re using port 53 for DNS on another service on the synology. You will need to change the port from 53 in the docker container. Try 5553 or something.

  3. Found this article; will purchase a Synology in a few days and bookmarked this blog. Great articles, thanks a lot for this and keep up this great work! 🙂

    1. Thanks a lot! I will went with the DS220+ which seems to be the right choice for me to do some file sharing (and pi-hole’ing ;)).

  4. Hi, I am not able to save any value (e.g. “8080”) for the variable “WEB_PORT”. After applying the settings no value is saved. Any ideas?

  5. Hi,

    I followed the how-to and upon startup of the container, the terminal is just looping this:

    Starting pihole-FTL (no-daemon) as root
    Stopping pihole-FTL
    kill: usage: kill [-s sigspec | -n signum | -sigspec] pid | jobspec … or kill
    -l [sigspec]
    Starting pihole-FTL (no-daemon) as root
    Stopping pihole-FTL
    kill: usage: kill [-s sigspec | -n signum | -sigspec] pid | jobspec … or kill
    -l [sigspec]
    Starting pihole-FTL (no-daemon) as root
    Stopping pihole-FTL
    kill: usage: kill [-s sigspec | -n signum | -sigspec] pid | jobspec … or kill
    -l [sigspec]

  6. Sorry, just tried this, but getting “can’t bind to port” and “cannot assign requested address”


    1. port 8080 may be used for something else. I didnt get an error but looking through the logs it said “Address is already used” or something like that. I changed the port to 8081 and it worked immediately

    2. Depends on your setup. As you said, if port 8080 is being used, just change it to something else.

    3. Sorry, no jooy.

      I’ve tried 8081, 8082, 8083, all same “(network.c.464) can’t bind to port: 8083 Cannot assign requested address”

      Also, prior assigning the port, I did a port scan and made sure nothing is responding to these ports before I start the Container.

  7. @mike @kev you should be able to host it on a pi zero w and it should still perform well. That said, I moved to AdGuard Home for the single binary and tls/https support among other things. Tracking is pervasive on the internet and slows down your browsing experience. Should be purely faster to not load ads and trackers.

  8. @VikingKong tried it maybe 2 years ago on a Pi 3B+ also. Web ui felt slow and clunky, and the Pi kept going down. I’d get maybe a few days before it would crash, overheat maybe, I dunno.About 6 months so I tried again and the image didn’t even work. I gave up at that point.

  9. @kev Ive been considering virtualizing my pihole, but not because of performance issues. Mostly for the fun of trying to do a k8s cluster approach. Ive been running pihole directly on a Pi Zero W for over a year now with great performance though.


  • Kristófer Reykjalín
  • DansLeRuSH ᴱᶰ 🐒
  • ottobin
  • lasombra

Leave a Reply

Your email address will not be published. Required fields are marked *