How to Install UniFi Controller on Your Synology NAS

How to Install UniFi Controller on Your Synology NAS

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.

UPDATE 8 October 2020: Try my new guide on how to install the latest Unifi Controller 6.

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

Install Docker via Synology “Package Center”.

1 install docker synology dsm

  • STEP 3

Open Docker Package. From the Docker Console, go to Registry and search unifi. Look for jacobalberty/unifi and select it, then click Download. You will be prompted to Choose Tag, select latest. Follow the instructions in the image below.

1 unifi controller Synology

  • STEP 4

After you click “Select”, the download process of the Unifi Controller docker container will start. You can click on Image on the Docker Console to see the download progress. The current container is about 703 MB. Follow the instructions in the image below.

2 unifi controller Synology

  • STEP 5

Go to File Station and open the docker folder. Inside the docker folder, create a new folder. Follow the instructions in the image below.

3 unifi controller Synology

  • STEP 6

Create a new folder and name it “dns“. Follow the instructions in the image below.

4 unifi controller Synology

  • STEP 7

Create another new folder and name it “unifi“. Follow the instructions in the image below.

5 unifi controller Synology

  • STEP 8

The final result should look like this. Follow the instructions in the image below.

6 unifi controller Synology

  • STEP 9

Now go back to the Docker Package. After the download is completed from the Docker Console, go to Image, then select the jacobalberty/unifi container. Click Launch. Check “Execute container using high privilege”, then click Advanced Settings. Follow the instructions in the image below.

7 unifi controller Synology

  • STEP 10

Select Enable auto-restart. Follow the instructions in the image below.

8 unifi controller Synology

  • STEP 11

Next tab – “Volume“. Select Add Folder. Follow the instructions in the image below.

add folder unifi controller synology

  • STEP 12

Choose the unifi folder, then click Select. Follow the instructions in the image below.

9 unifi controller Synology

  • STEP 13

After you click Select, type /var/lib/unifi inside Mount path. Follow the instructions in the image below.

10 unifi controller Synology

  • STEP 14

Next tab – “Network“. Check “Use the same network as Docker Host” then click Apply. Follow the instructions in the image below.

11 unifi controller Synology

  • STEP 15

After clicking “Apply“, the screen below will open. Click “Next“. Follow the instructions in the image below.

12 unifi controller Synology

  • STEP 16

After clicking “Next“, the screen below will open. Select “Run this container after the wizard is finished” then click “Apply“. Follow the instructions in the image below.

13 unifi controller Synology

  • STEP 17

Go back to STEP 1 or you will deal with karma 🙂. Now open your browser and type in https://Synology-ip-address:8443/ then click Advanced. Follow the instructions in the image below.

14 unifi controller Synology

  • STEP 18

Click to Proceed to your local NAS IP (unsafe). Follow the instructions in the image below.

15 unifi controller Synology

  • STEP 19

Install and set up the UniFi Controller according to your preference. Enjoy!

16 unifi controller Synology

Note: On STEP 9 you can change the container name according to your preference.
Note: (Reported by Neil Brewster @neilschmeel) After STEP 14 you can set some Environment variables before proceeding to STEP 15. I recommend to change in the container’s Environment variables the line RUNAS_UID0=true into RUNAS_UID0=false and the line BIND_PRIV=true into BIND_PRIV=false

Summary:

  • In the container’s Environment variables Look for “RUNAS_UID0” and set its value to “false” instead “true“.
  • In the container’s Environment variables Look for “BIND_PRIV” and set its value to “false” instead “true“.

Note: Find out how to update UniFi Controller container with the latest image.

This post was updated on Thursday / October 8th, 2020 at 9:25 PM