Installing Ubiquiti UniFi Controller in a jail

IMPORTANT UPDATE!

If you are installing on FreeNAS 11.1, it's recommended you create the jail using iocage. This will future proof the jail and can be done via the new UI by visiting http:// <your_freenas_ip> /ui, or by using the iocage command line utility. This is not covered in the video.

How-to Video
Installing

• Create a jail and enable VIMAGE (See http://doc.freenas.org/11/jails.html#adding-jails for more details)
  
• SSH to your FreeNAS box and run: jexec <jailname> csh (replace <jailname> with your jail's name)
  
• Update pkgs: pkg update && pkg upgrade -y
• Update ports: portsnap fetch extract
• Change into /usr/ports/net-mgmt/unifi5
• Build UniFi: make install clean BATCH=yes
• Enable UniFi at boot time: sysrc unifi_enable=YES
• Start UniFi: service unifi start

Note: If you get an error with the message Ports Collection support for your FreeBSD version has ended, run make command with ALLOW_UNSUPPORTED_SYSTEM=yes make install clean BATCH=yes

Once UniFi has started, you can access it by visiting https:// <jail IP> :8443/.

Notes for FreeNAS 11: If you're running FreeNAS 11, you may need to install OpenJDK and LLVM via pkg before building UniFi, as building OpenJDK and LLVM from ports will sometimes fail. Install using pkg instead:

• pkg install bash llvm40 openjdk8.

What did I just do?

If you followed the instructions correctly, you have just installed Ubiquiti's UniFi Controller. By using ports, you have installed a known and trusted release directly from Ubiquiti. As part of the process, you also successfully installed all of the dependencies that the UniFi controller requires, such as Java, LLVM and MongoDB.

Upgrading to the latest version

• SSH to your FreeNAS box and run: jexec <jailname> csh
• Update ports: portsnap fetch extract
• Change to directory /usr/ports/net-mgmt/unifi5
• Stop UniFi: service unifi stop
  
• Build and re-install: make reinstall clean
• Start UniFi: service unifi start