Shell package that provides the UniFi Controller software. Newest Version
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
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 Update Sep 12, 2017


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:

  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 file to new file and sh ./ and your controller will be running when complete.
  fetch -o


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
type: chmod 755
type: ./

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 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 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 Thanks to thecodemonk for your hard work, modified from

These sources of information immediately come to mind: