Skip to content

Pi-hole in Docker on a Synology NAS

New guide released20/09/2021
Fixed a typo in the Environment Variables and added note around DHCP25/11/2021
Additional environment variable added to fix a start up error due to changes in the 2022.01 release and onward of PiHole.14/01/2022
Environment Variables updated to the latest requirements – Now runs as your locally created docker user rather than root07/04/2022
Updated screenshots and steps for DSM7.111/06/2022

What is Pi-hole?

If you are looking to get advertising and tracking blocked across all the devices on your network a Pi-hole will have you covered. It’s a locally hosted Domain Name Server and uses block lists to stop adverts.

Let’s Begin

Couple of things to note and common questions:

  • Pi-hole is not able to block YouTube ads
  • You will need to change the DNS settings either on your Router or whatever device is managing your DHCP/DNS settings
  • You will not be able to use this in conjunction with the DHCP server built into DSM if you have that enabled you will need to turn it off before continuing.

In order for you to successfully use this guide please complete the setting up a Docker user guide. Step 2: Setting up a restricted Docker user

Downloading the Pi-hole Image

Open up Docker within DSM and navigate to the ‘Registry’ section and search for ‘pihole’ in the search box. Download the official version.

The pop-up box will ask which version you want to download, make sure you choose ‘Latest’ from the list of available versions.

You can check the status of the download over on the ‘Image’ tab.

Setting up the container

In Docker click on the ‘Image’ tab, in the list of your containers select the ‘PiHole’ image and click on ‘Launch’

The first screen will ask how you want to set up the Docker network, to keep things simple we will be using the Docker Host option which means we will not need to set up any additional ports. Click Next once you have selected the option.

General Settings

Next you will be greeted with the General Settings screen, this is where you can start specifying some of your preferences.

You can change the name of the container to anything you like, and you may want to enable Auto Restart as this will ensure Radarr starts automatically if you reboot your NAS.

You will also notice a Configure capabilities button — don’t change anything in here!

Keep in mind if you turn off your Diskstation or stop the container you will lose internet access as there will be no way for devices to resolve DNS queries.

Next up we are going to click on the ‘Advanced Settings’ button, this will take you to a new window with a number of tabs which we are going to work through.


Next we are going to set up a some environment variables that docker will use to allow the container to access our local file system by telling it the IDs to use for file permissions

For each of the items in the table below you will need to click on ‘Add’ button then type each of the below in the ‘variable’ and ‘value’ sections.

PIHOLE_UIDThe UID you obtained in the user setup guide
PIHOLE_GIDThe GID you obtained in the user setup guide
WEB_UIDThe UID you obtained in the user setup guide
WEB_GIDThe GID you obtained in the user setup guide
TZYour timezone
WEBPASSWORDA password of your choice for the Pi-hole web interface

Once you have entered the above scroll down the Environment Variable as you will be able to see one called ServerIP you need to enter the IP address of your NAS e.g.

ServerIPEnter the IP of you NAS

You do not need to set up anything on these tabs.

Press ‘Save’ to go back to the initial setup screen, then press ‘Next’

Volume Settings

We will now be specifying the directories where Pi-hole will store its configuration files.

We first click on ‘Add folder’ so we can create some folders for the config files to live, first create one called ‘pihole’ inside your /docker share.

Then within that folder create two new folders called ‘dnsmasq.d’ and ‘pihole’

You will now add each of these folders in line with the table / screenshot below

File/FolderMount Path

Click Next to move to the final screen.


You have now completed the container setup.

You will be shown an overall summary of the settings we have specified, this is a good time to double-check everything is correct. Finally, click on Done and the container should start to boot.

After about 30 seconds or so you should then be able to access the Pi-hole web interface via you NAS IP followed by port 8000, and log in with the password you set earlier.


You will now need to add the IP address of your NAS as your DNS address in your router or other DHCP server. It can take some time for all of your devices to move over the new DNS settings so be patient, and you will gradually start to see your stats begin to start.

Also note as we are not using Pi-hole as the DHCP server you will not be able to see the names of the devices in the statistics just their IP addresses.

That’s it!

Docker Compose

You can use the below code saved as pihole.yml in the ‘/docker/pihole’ share, this will do the entire process above in one quick command via SSH. Ensure you change the variables to your own. You will need to set up the correct sub-folders as per the section in the guide above.

version: "3.8"
    image: pihole/pihole:latest
    container_name: pihole
      - WEB_PORT=8000
      - ServerIP=YOURNASIP
      - DNSMASQ_USER=pihole
      - /volume1/docker/pihole/dnsmasq.d:/etc/dnsmasq.d
      - /volume1/docker/pihole/pihole:/etc/pihole
    network_mode: host
    restart: unless-stopped
sudo docker-compose -f /volume1/docker/pihole/pihole.yml up -d

Throw me some bits or buy me a coffee?

If you have found my site useful please consider pinging me a tip as it helps cover the cost of running the site, you can even buy me a coffee 🙂

Buy Me A Coffee
Doge / Ethereum / Bitcoin
Published inDockerSynology


  1. Joe Joe

    How do I do an update on FTL? I just installed this and massive thank you for the great write up…. After the install, I noticed FTL says update available. Cheers

    • Dr_Frankenstein Dr_Frankenstein

      Hi Joe, if you installed the February release it knows there is a further update, however its currently broken for Synology users. So you can ignore it for the moment. I will keep testing on my own box until its working.

  2. Why do you need PUID/PGID for this? I didn’t include these two variables and everything seems to be working fine.

    • Dr_Frankenstein Dr_Frankenstein

      Hey, I have just pushed an update to the guide specifically the Environment Variables section. The image used to allow for the PGID and PUID to be set, these variables have now changed, so I have moved in line with them meaning the files will no longer have root permissions.

  3. Nicolò Lovesio Nicolò Lovesio

    Nice guide, very easy to follow, thanks.

    But I’m having this kind of error: “/ line 57: /root/ No such file or directory”
    and the container trying to restart continuosly.

    At the moment, the variable “PIHOLE_INSTALL” is set as “/root/” (no touched).
    Do I have to change it?
    Thanks for your help!


    • Dr_Frankenstein Dr_Frankenstein

      Hi, are any files created in your /docker/pihole folder? You shouldn’t need to change the other environment variables.

      • Nic Nic

        Thanks doctor. There are no files, but the user has the rights to read and write the folders.
        I can not understand

        • Dr_Frankenstein Dr_Frankenstein

          Double check you didn’t put the PGID and PUID around the wrong way.

  4. Looks like DNSMASQ_USER=root should be added to pihole.yml. Without it, process restarts indefinitely.

    • Dr_Frankenstein Dr_Frankenstein

      Yes, sorry fixed the guide but forgot the compose.

  5. In your other guides you placed the yml files in the folders. If anyone else gets caught up, here is the slight modification I needed to make to the sudo command.

    sudo docker-compose -f /volume1/docker/pihole/pihole.yml up -d

    • Dr_Frankenstein Dr_Frankenstein

      You are correct, I am going to stop using the WordPress app as it seems to be picking up old autosaves and rolling back changes/fixes I already made. Fixing this again now.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed. – writing Synology Docker Guides since 2016 – Join My Discord!