A shell script package that provides the UniFi Controller software.
The objective of this project is to develop and maintain a package that provides Ubiquiti's UniFi Controller software for the FreeBSD-based jail. Current stable version 5.5.20
The project now provides two working scripts: an rc script to start and stop the UniFi controller, and an installation script to automatically download and install everything, including the rc script.
Upgrade to current is working to 5.5.20 (possibly)
Installs snappy java after Unifi Controller is installed to comply with new controller software.
This project itself is licensed according to the two-clause BSD license.
The UniFi Controller software is licensed as-is with no warranty, according to the README included with the software.
Ubiquiti has indicated via email that acceptance of the EULA on the web site is not required before downloading the software.
To install the controller software and the rc script:
- Log in to the jail command line shell as root.
- Run this one-line command, which downloads the install script from Github and executes it with sh or copy install_unifi.sh file to new file and sh ./filename.sh and your controller will be running when complete.
fetch -o install-unifi.sh https://raw.githubusercontent.com/TechButton/unifi-controller-freebsd-freenas/master/install-unifi/install-unifi.sh
Login with SSH to your FreeNAS (or alternatively go to shell in WebGUI) type: 'jls' (without ' ' ) and take the note of the # of jail of your Unifi installation type: jexec # csh' (where # is the number of the jail noted in last step) type: fetch -o install-unifi.sh https://raw.githubusercontent.com/TechButton/unifi-controller-freebsd-freenas/master/install-unifi/install-unifi.sh type: chmod 755 install-unifi.sh type: ./install-unifi.sh
The install script will install dependencies, download the UniFi controller software, make some adjustments, and start the UniFi controller.
Starting and Stopping
To start and stop the controller, use the
service command from the command line.
To start the controller:
service unifi.sh start
The UniFi controller takes a few minutes to start. The 'start' command exits immediately while the startup continues in the background.
To stop the controller:
service unifi.sh stop
The the stop command takes a while to execute, and then the shutdown continues for several minutes in the background. The rc script will wait until the command received and the shutdown is finished. The idea is to hold up system shutdown until the UniFi controller has a chance to exit cleanly.
Current Version 5.5.20 fixes https://community.ubnt.com/t5/UniFi-Updates-Blog/UniFi-5-5-20-Stable-has-been-released/ba-p/2011817 Thanks to thecodemonk for your hard work, modified from https://github.com/thecodemonk/unifi-pfsense
These sources of information immediately come to mind: