How to install Ubiquiti UniFi Controller in Docker on Synology NAS

Xavier Mustin

Staff member
I’ll assume your Synology NAS does support Docker and you’ve already installed the Synology Docker app on your Synology NAS.

  1. SSH into your Synology NAS using PuTTy or other terminal of your choice, login using your account with admin access.
  2. Now lets pull, or download, the UniFi Controller Docker container from the Docker Hub by typing the following command:
    sudo docker pull jacobalberty/unifi:latest

  3. Next lets run the new UniFi Controller container by typing the following:
    sudo docker run -d --name unifi-controller --net=host jacobalberty/unifi:latest

  4. Now finally, open a web browser and go to: https://<SYNOLOGY_IP>:8443
Configuring Ubiquiti UniFi Controller in Docker
Now we’ll just need to finish the UniFi controller setup by following the wizard once you’ve loaded https://<SYNOLOGY_IP>:8443 in your browser from the above steps.

  1. First, set your country and timezone then click Next.
  2. The UniFi controller will automatically find any access points on the same network, select the access point you’d like to configure for the Docker UniFi controller to manage and click Next.
  3. Enter the SSID you’d like your wireless network to be named and a password then click Next.

    Optionally, you can also configure a guest wireless as well by checking the “Enable Guest Access”.
  4. Now set the login user and password. This will be used to access the Docker UniFi Controller management page. Then press Next.
  5. Finally, review that the SSID and User names both look correct then press Finish.
Once the wizard has completed your Ubiquiti access point will be adopted, configured and ready to connect to from any of your wireless devices.

It is a good idea to log into the UniFi Controller management page (https://<SYNOLOGY_IP>:8443) and check the firmware status of the access point. As shown below the access point is still functioning but also showing us that a upgrade for the access point is available. Simply click on the “Upgrade” link and the UniFi controller will automatically upgrade it within just a few minutes.

The benefits of running the Ubiquiti UniFi controller in Docker on the Synology NAS is that it’s free (if you already own the Synology NAS) and super simple to setup. Depending on your Synology specs, such as a Synology DS1815+, you could easily manage several access points and sites using the docker UniFi controller and upgrading to 16GB RAM will certainly help with resources.

I still prefer hosting my UniFi Controller in the cloud using Linode, Vultr, or DigitalOcean if only for the fact my UniFi controller isn’t tied to my home/business network. Which means I’ll get email notifications if an access point goes offline. An important function for me as I manage several access points for other places and people.

Otherwise, if you are looking for a great solution for your home or business then the UniFi Controller in Docker is perfect fit!