Deploy and Run the Unifi Controller on a Synology Nas with Docker

/ August 15, 2022/ Uncategorised, Uncategorized

While installing the second Ubiquiti Access Point. The need of roaming the same Wifi network seamlessly on different floors is needed to maximized the user experience. This solution can be done at home, small and medium businesses with a Synology nas or any other docker solution. In the next blog post I will install the Unifi controller on vSphere. 

First things first….. One of the requirements is that the Synology Nas must support Docker. You can check this if the package is available in the Package Center or check the vendor website if your model support it. There are many versions of Synology and therefore is this a important step to begin.

  1. Login on the Synology Nas
  2. Open the package Center
  3. Search for Docker
  4. Install Docker on the Nas.
  5. Check if Docker has been successfully installed. 

Configure the Synology Firewall

The Synology firewall is by default turned on. Therefore you need to allow specific ports to allow traffic to the Unifi controller. In certain cases you can choose to disable the firewall. This is not advised and needs a third party hardware firewall. In this blogpost we will specify specific firewall ports.

  1.  Go to the Control panel, select Security and the sub cat. Firewall
  2. Edit the Rules
  3. Rule 1 (custom)
    Type: Dest.port
    Protocol: TCP
    Ports: 8080,8443,8843,8880,6789
  4. Rule 2 (custom)
    Type: Dest.port
    Protocol: UDP
    Ports: 3478,10001

Download and Run the Unifi controller software

  1. Open Docker
  2. Go to Registry *1
  3. Search for Unifi *2
  4. Select “jacobalberty/unifi” and click on Download *3
  1. Go to Image within Docker
  2. Select “jacobalberty/unifi:latest”
  3. Click on Launch

Configure the Unifi access controller

After launching the Unifi container, a configuration wizard will start to specify the basis settings of the Unifi controller. Basic settings are “Resource management, Container name, Auto-restart, Shortcut, Network, ports and volumes” All these settings can be set with a user friendly interface. (no commands etc) Please follow the bellow steps 😉

 Select “Use the same network as Docker Host

  1. Specify the container name (give it a nice and simple name)
  2. Enable resource limitation
  3. Set CPU Priority to Low
  4. Set Memory Limit on 1024MB (my advise, based on my Nas specifications with 4 GB of Ram)
  5. Enable auto-restart

Advanced Settings

  1. Change the Variable “Bind_Priv” to False
  2. Change the Variable “Runas_Uid0” to False


Volume Settings

  1.  Under docker, create folder with the name of the container
  2. Specify the mount path ( /virtualblog)
  3. finish the wizard and the container will be created and started 


When the Container is successful deployed. You should be able to reach the controller on the specified port 8443 (https://IPNas:8443/) 

Thanks for reading and good luck with configuring Docker and the Unifi controller 😉

Leave a Comment

Your email address will not be published.

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>