/unifi-controller-freebsd-freenas

Shell package that provides the UniFi Controller software. Newest Version

Primary LanguageShellBSD 2-Clause "Simplified" LicenseBSD-2-Clause

UPDATED: 5.9.29

unifi-controller-freebsd-freenas

A shell script package that provides the UniFi Controller software.

Purpose

The objective of this project is to develop and maintain a package that provides Ubiquiti's UniFi Controller software for a FreeBSD-based jail or any BSD/Linux distrubition unsupported by Ubiquiti. 5.9.X Version branch - Stable Canidate Status.

Status

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

Re-run the install script and it will update to the version in the script.

Milestones

Installs snappy java after Unifi Controller is installed to comply with new controller software.

Challenges

Licensing

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.

Installation

To install the controller software and the rc script:

  1. Log in to the jail command line shell as root.
  2. 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/jmkizer/unifi-controller-freebsd-freenas/5.9.X/install-unifi/install-unifi.sh

Or

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/jmkizer/unifi-controller-freebsd-freenas/5.9.X/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.

References

Version 5.9.29 fixes https://community.ubnt.com/t5/UniFi-Beta-Blog/UniFi-SDN-Controller-5-9-29-Stable-Candidate-has-been-released/ba-p/2506740

Thanks to thecodemonk for your hard work, modified from https://github.com/thecodemonk/unifi-pfsense and https://github.com/TechButton/unifi-controller-freebsd-freenas

These sources of information immediately come to mind: