A lightweight software containerization solution powered by Docker Inc. By leveraging this cutting-edge technology, Synology delivers even more packages for seamless deployment on your NAS, such as Redmine or GitLab.
More possibilities in DSM
Docker is a lightweight virtualization application that gives you the ability to run thousands of containers created by developers from all over the world on DSM. The hugely popular built-in image repository, Docker Hub, allows you to find shared applications from other talented developers.
On my side, to update a container using Synology docker GUI, I just first download the new container image as you did (Through the registry), then stop my container to update, then Actions Clear. And finally just start the container / done! This trick do not delete my config and data and upgrade “in place” my container. Hope this helps. Sep 28, 2017 Synology has limited Docker availability in the package manager to only some select models (models and links updated ) 21 series:DS1821+, DS1621xs+, DS1621+, DVA3221 20 series:FS6400, FS3.
- Applied Models.The models of this series are not compatible with the latest version of DSM. For details, please refer to the Product Support Status page. Please note that DS712+, RS2211RP+, RS2211+, DS411+II, DS411+, DS2411+, and DS1511+ are not compatible with Active Backup for Business since they do not support Btrfs.
- Now the image is in Docker Hub, you can enable Docker support on the Synology NAS, pull the image from Docker Hub, and start a container on the NAS. First log into the Synology as an admin account and open the Package Center. Here you can search for “Docker” and install the Docker app.
Flexible container deployment
Deploy Docker containers at will and facilitate the maximum utilization of your Synology NAS.
Download Docker For Synology
Download the GitList image to your Synology Search for the keyword 'GitList' on the Registry tab in the Docker application and download it. If you need more instructions, check this.
Container import / export
Support for container import / export makes backup and transfer of containers simple and easy.
Docker® Hub Registry
The built-in Docker® Hub Registry enables you to directly search for thousands of applications from developers around the world.
At-a-glance resource monitoring
The overview provides a clear dashboard including the NAS CPU, memory and individual container resource usage.
I’ve been running Pi-Hole on my Synology for a good few years. It has taken me a while to figure out how to run it the way I liked to which is why I wrote the previous guide a few years ago. (see: Running Pi-Hole inside Docker on Synology)
Although this has helped me and many others, I was never quite happy about the outcome and have strived to find a better way. I didn’t want to have to rely on WebStation or anything else outside of the docker container. Thankfully I stumbled upon dockers network driver named macvlan.
Note: I will be using the command line in this guide however the containers will still be visible in the Synology Docker UI.
TL;DR (too long, don’t read)
Download the docker-compose.yaml1 file to your Synology, edit all the network addresses replacing the example network 192.168.123.X with your own network. and run the following command:
If it all works Pi-Hole will be running on IP .199. Continue reading to understand (hopefully!)
If your names is using IP x.x.x.199 then please change the above!
Using macvlan for networking
Macvlan is a network driver provided by Docker, the following is an extract from the documentation
Some applications, especially legacy applications or applications which monitor network traffic, expect to be directly connected to the physical network. In this type of situation, you can use the macvlan network driver to assign a MAC address to each container’s virtual network interface, making it appear to be a physical network interface directly connected to the physical network.
So the idea is that we will create our own docker network using the macvlan driver, this will then allow us to connect our Pi-Hole container onto this network which will assign it it’s own MAC. This will then appear to be directly connected on our host network but will have it’s own IP and therefore all network ports available.
Synology Docker Container Download
A new network can be easily created using the following command (but hold off, we’ll go into actually doing this later using configuration files)
In all my examples I will be using the network 192.168.123.0/24. If you use any of the downloaded files please update these entries to your specific network.
Note: The IP address range in the above command of 192.168.123.192 / 28 might appear strange. This is so that we can restrict the IP addresses docker uses so not to clash with our physical machines see IP calculator.
Making things easier using docker compose
I’m quite a lazy guy when if comes to repitition. I quickly became fed up of clicking around the docker UI to create containers, update containers and to modify them. Luckily docker comes with a way to automate this setup with the command docker-compose. I now use this to create all my containers that I run but in this example we will focus on Pi-Hole.
Note: I’m using version 2 of the docker compose format. This is the only version that seems to support specifying MAC and IP addresses which to me is very handy. It only needs to be specified once at the top of each file.
Docker compose requires a configuration file that is in YAML format. This is just plain text so can be edited using any application however, whitespace is important so no TAB characters please.
In the docker compose file we can create the network (macvlan), we can create our service (Pi-Hole) and optionally assign specific MAC and IP addresses. I will explain each section individually to build up the complete picture. I will also attach a download link at the bottom of the article so that you are not forced to copy & paste.
If you want to follow along then ssh to your Synology, create a file name docker-compose.yaml and add the following snippets. You can then try this out running the following command in the same place as the file you created. This command will re-create the config each time so you do not need to delete previous versions.
For more information try sudo docker-compose up —help
Start by specifying the version.
Defining the network:
This creates a new network named pihole_network using the parent network interface ovs_en0. This will be visible in the Synology docker UI under networks.
Please check your network interface using ipconfig and change the parent device above to match.
Next we need to add our Pi-Hole container. This can be added with the following configuration.
We specify our containers name, image and various networking information plus the environments required by Pi-Hole.
The combination of these two configurations are all that is required to create and run Pi-Hole on your Synology NAS. The complete file can be downloaded here.1
Synology Docker Package Download
If you need more information the documentation can be found here.
How do we use docker compose
Assuming you have your docker compose file correctly setup (either writing your own or downloading one of mine) you can now start up Pi-Hole from the command line. If all works out then Pi-Hole should now be up and running and visible inside the Synology Docker UI.
Docker compose requires root access which will ask for your admin password. The -d is needed to run in daemon mode, if we do not supply this then the command will block in the shell.
How do we go about updating - you might ask?
Updating to the latest image is very easy. You can run the following commands.
Optionally you can specify the service $sudo docker-compose up pihole if you have mulitple services
This will download the new version and then re-create the updated Pi-Hole container.
Optional step; one file per container
As I have many containers running on my Synology I separated each service into it’s own file and included it along with it’s configuration and volumes. This way I can compose many docker files together rather than having one huge file. This is accomplished by the following in my main docker-compose.yaml file in the full example:
Downloading the combined2 file will give you the mulitple docker files, or you can download the single1 file for a basic simple container.
Head over to my project on gitlab to see all files in full 3