Self-host the Unifi Controller on a Synology NAS

This tutorial will show how to self-host the Unifi Controller on a Synology NAS.

Certain Unifi devices come preinstalled with the Unifi OS, or it can be added to an existing, non-supported Unifi network by using a Cloud Key. However, it’s incredibly easy to get the Unifi Controller running on a Synology NAS. In my opinion, a Synology NAS is one of the best appliances to run the Unifi Controller on, as it’s generally running 24/7 and can be updated/backed up relatively easily.

I’ve been running the Unifi Controller on my Synology NAS since I started using Unifi networking gear and it’s run flawlessly. The instructions below will bring you through the entire process and show how to self-host the Unifi Controller on a Synology NAS.

1. Instructions - How to Self-Host the Unifi Controller on a Synology NAS

1. Ensure that the Docker package is installed on your Synology NAS.

2. Create a subfolder under the Docker folder named Unifi-Controller. We will use this folder at a later step to map our configuration.

unif controller synology1

3. Open Docker, select Registry, search for unifi, then download the latest jacobalberty/unifi image.

self-host the unifi controller on a synology nas

4. After the image is finished downloading, select the Image tab, then double-click the newly downloaded image to create a new container.

unif controller synology3

5. Name the container Unifi-Controller, then select Advanced Settings.

unif controller synology4

6. Enable auto-restart, then select Volume.

unif controller synology5

7. Select the Unifi-Controller folder that we created earlier and set the mount path as /unifi.

unif controller synology6

8. In the Network section, select Use the same network as Docker Host.

unif controller synology7

9. Select Environment and add a new environment variable named TZ. Set the value to be your time zone.

unif controller synology8

10. Scroll down to see the BIND_PRIV (bind to lower ports) and RUNAS_UID0 (run as root) variables. These are set as true by default, but are not necessary (bind) or suggested (run as root), so set both of these values to false.

unif controller synology9

11. Select Apply, then Next to create the container. Give the container a few minutes to install (be patient as it might take some time). If you are using Synology’s Firewall (which is suggested), create a TCP allow rule for port 6789, 8080, 8443, 8843, and 8880. Create a UDP allow rule for port 10001 and 3478.

unif controller synology10

12. Navigate to the IP address of your Synology NAS and port 8443 using HTTPS. NOTE: If you receive a 404 error, wait a little longer as the container might not be finished setting up.


13. Give your controller a name (or restore from a backup if you have a backup), accept the terms of service and select Next.

unif controller synology11

14. If you’d like to sign in with a Ubiquiti account, you can do that at step 2. This will allow you to access the Unifi Controller using Unifi’s website (or mobile application).

unif controller synology12

15. If you’d prefer keeping everything local, select Switch to Advanced Setup, uncheck Enable Remote Access and Use your Ubiquiti account for local access, then create a local account.

unif controller synology13

16. Determine if you’d like to enable auto backup and if you’d like your network to be automatically optimized.

unif controller synology14

17. This next step will determine the devices that are waiting to be configured. If the devices are already assigned to another Unifi Controller, you will not see any here, but if you haven’t, you should see a list of your devices.

unif controller synology15

18. If you’re setting up an Access Point or Router + Access Point combo unit (like the Unifi Dream Machine or Unifi Dream Router), you will be able to configure your Wi-Fi settings here.

unif controller synology16

19. Confirm your settings and Finish. The Unifi Controller is now set up!

unif controller synology17

Conclusion - Self-Host the Unifi Controller on a Synology NAS

This tutorial showed how to self-host the Unifi Controller on a Synology NAS. I have been running the Unifi Controller for a while on my Synology NAS and it’s run flawlessly! It’s important to understand that updates are periodically released, and you should check the containers release notes to see when you’d like to update your container.

Thanks so much for checking out the tutorial!

Leave a Reply

Close Menu