pihole inside Synology Docker

Download the image

  1. Open the Docker application inside the DSM portal
  2. Select Registry in the left menu
  3. Use the search box on the right and search for pihole
  4. Once the image was found, right click it and choose Download this image
  5. You can select the version you want to download, default: latest
  6. If you open the image menu von the left you will see an animated database logo next to your new image. It proofs that the download is in progress.
  7. DSM will show a notification (top right) once the download has finished

Launch the image (create a container)

  1. Click on image in the left menu 
  2. On the right click on the next cloud image you just downloaded
  3. Click on Launch in the top menu
  4. In the popup window click on advanced settings
  5. Check enable auto-restart
  6. Under the network tab select the checkbox on the bottom [] use the same network as docker host 
    It's important to understand that this will require the free port 53 on your NAS. Alternative solutions are available but I won't describe them here.
  7. Under the environment tab set / add
    ServerIP =  the IPv4 address of your NAS
    optional: ServerIPv6 = the IPv6 address of your NAS
    WEB_PORT= e.g. 8888 or any other free port on your NAS, for the pihole web interface
    WEBPASSWORD = mypassword / or leave this empty for no password
    TZ = your tz database timezone code (see here)
  8. Finish the wizard

Using pihole

1. Check if the web interface comes up under http://YOURIP:YOURPORT/admin

Older versions required the /admin otherwise you'd have seen an error message!

2. For a manual test modify your PCs DNS server to the ip address of your pihole. If it works, change the DNS server in your router to your pihole

Updating pihole container

  1. Export your settings via the pihole web UI (Settings - Teleporter - Backup)
  2. In the docker registry download the latest image version
  3. Stop your running pihole container
  4. Clear the docker container (Synology: Docker - Container - ACTIONS - clear)
  5. Start the docker container
  6. Import your settings via Teleporter (see 1.)