Shell package that provides the UniFi Controller software. Newest Version
Shell
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 13 commits ahead, 1 commit behind thecodemonk:master.
Latest commit 2da42b7 Dec 30, 2017
Permalink
Failed to load latest commit information.
install-unifi UniFi software URL update Dec 30, 2017
rc.d Startup delay fix Mar 29, 2015
LICENSE Initial commit Oct 10, 2013
README.md Update README.md Sep 12, 2017

README.md

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 the FreeBSD-based jail. Current stable version 5.5.20

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

Upgrade to current is working to 5.5.20 (possibly)

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/TechButton/unifi-controller-freebsd-freenas/master/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/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.

References

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: