Install Unifi Controller Synology

  1. Install Unifi Controller Synology Software
  2. Install Unifi Controller Synology Free

Step 3: Open docker and install the jacob alberty docker image for UniFi controller Jacob alberty created and supports this easy to deploy docker image for the UniFi controller. He has a great reputation in the Docker community, and I have personally been running this container for around a year with no issues. The UniFi Controller is a wireless network management software solution from Ubiquiti Networks. It allows you to manage multiple wireless networks using a web browser. In this step by step guide I will teach you how to install UniFi Controller on your Synology NAS device using Docker. Install and upgrade the UniFi Network application. Note: On some Distributions, it's possible an incompatible Java release can be installed during this step. We recommend running the following command before proceeding with this step, to restrict Ubuntu from automatically installing Java 11.


One challenge I ran across when deploying a UniFi network in my own home was, where to place the controller? The UniFi controller from Ubiquiti networks can be run on almost any hardware. The controller functions best when it is always running on the network, eliminating the option of running it on my workstation. They do offer a device called a Cloud Key, but the first generation was ripe with problems and the 2nd generation is a little too pricy to use just for the network management aspect, although it does start to show value if you use it as an NVR for UniFi cameras.

I decided to do some digging and found that someone had made it pretty easy to run the UniFi controller on a Synology NAS. I am running a Synology DS218+ at home so I decide this would be the best option for me.

This guide will show you the method I used to deploy this in my own network, it is by no means the only way to do this or the best way its just my way.

Step 1: Install Docker from the DSM package center

  1. Log into your Synology device and open the Package Center from the main menu of disk station manager

  2. in the search bar search for Docker

  3. Click install next to the Docker Package

  4. Docker will now install on your Synology

  5. Launch Docker from the main menu

Step 2: Create a UniFi folder to store the UniFi config files

Now that Docker is installed you will need to create a folder to store the UniFi controller configuration files so that in the future you can tear this docker container down and rebuild it with a newer version of the UniFi controller without having to back up the controller. It really makes updating easy.

  1. Open the file Station on your Synology and brows to the docker directory created when you installed docker. (If the directory does not exist create one named docker)

  2. In the docker directory create a folder named UniFi (See fig 2-2)

Step 3: Open docker and install the jacob alberty docker image for UniFi controller

Jacob alberty created and supports this easy to deploy docker image for the UniFi controller. He has a great reputation in the Docker community, and I have personally been running this container for around a year with no issues. He also provides updates often so you can update to the newer UniFi controllers when they are released.

  1. Launch Docker from the main menu of your Synology

  2. on the left-hand side select “Registry”

  3. Use the search bar and search for “UniFi”

  4. Select the Jacobalberty UniFi docker image and select download (see fig 3-4)

  5. When prompted select “latest” from the dropdown menu of available images

Step 4: Configure the image and deploy the container

In this step you will configure the options in the initial deployment package and deploy the image for use on your network.

  1. On the left-hand navigation menu select “Image”

  2. Select the Jacobalberty UniFi image you just downloaded

  3. Press launch in the top of the docker window

  4. A new window will open, and you can name your new docker container (See fig 4-4)

  5. Select “Advanced Options” this will launch a new advanced configuration window

  6. Under the first tab “advanced settings” check the option for “enable auto-restart” (See fig 4-6)

  7. Move to the “network” tab and check the box for “Use the same network as Docker host” box (See fig 4-7)

Step 5: Mount the docker container to the unifi folder created in step 2


This step is crucial if you want to be able to tear down this container and rebuild later with a newer image. If you don’t do this, you would need to back up your UniFi controller anytime you wanted to update. Also, this has the added benefit of keeping your UniFi controller backed up to your Synology where there is most likely fault tolerance.

  1. Select the “volume” tab

  2. Select the add folder button

  3. brows to the Unifi folder you created under the docker directory and press select (See fig 5-3)

  4. set the mount path to /var/lib/unifi (See fig 5-4)

  5. Click apply to save the volume configuration

  6. Click apply again to save all of the advanced configurations

  7. On the general settings page select next (See fig 5-7)

  8. On the summary page, review all settings and click apply (fig 5-8)

Step 6: Log into your new UniFi controller and have fun!

Install Unifi Controller Synology Software

after you apply the final configuration, docker should spin up the container and you should see it running in the “container” section of the left navigation window.

  1. Open a web browser and brows to the web interface of the UniFi controller (Hint: Use the IP of your Synology followed by :8443 for example in my case I brows to where is the internal IP of my Synology.)

  2. Click advanced and proceed through the not valid certificate error

  3. You should now see the web interface of a new UniFi controller, you can either configure for first use or import a backup configuration file of a previous Unifi install.

I hope you found this guide helpful. I am always looking for new projects and am hoping to keep my blog updated with some of those projects. If you have any request for tutorials, please reach out to me through the contact us page on the website and I will try to accommodate any request. If you are interested in hiring Albuquerque Tech you can contact us through the same link!

Install unifi controller synology download

Information for users of repository
I offer you a new version of Ubiquiti Controllers for Synology:

  • UniFi Wireless Controller (former UniFi Controller version 3.xx, for those who use the controller only to access points).
  • UniFi Controller (new UniFi Controller version 4.xx, for those who use the controller to the access points and other equipment from the UniFi Switching & Routing equipment).
  • mFi Controller (controller form mPower and mPort devices).
Install Unifi Controller Synology

The main difference of the new packages:

  • Now before installing the controller does not need to be installed separately MongoDB.
  • After the upgrade DSM on Synology – no need to reinstall MongoDB.
  • Each controller contains MongoDB server version 2.2.7, which recommends by Ubiquiti.
  • During installation, you can now set the controller ports for the web-interface of the controller, as well as you can change the system ports, to prevent conflicts with other packages (eg service SABnzbd, which also uses port 8443).
  • The script for starting the controller has been rewritten, now, in the event of an error on startup, error text will be displayed on the screen.
  • All three packages can coexist on a single Synology, important not to cross the ports.
  • And finally, during the installation of new packages (as well as during migration UniFi Controller <> UniFi Wireless Controller), you can import the previous database and logs.

Don’t forget to make a backup of previous version UniFi Controller before migrating!!!

Previous versions of the controllers (depending on the package with MongoDB) is now considered deprecated and will be removed from the repository. The package itself MongoDB will as before be present in the repository, but later it will be split into branches 2.2, 2.4 and 2.6.

2016-01-27 update: Please, read the latest news about UniFi Controller on Synology.

Additional links:

Install Unifi Controller Synology Free

  • Information about my Synology Test Lab