You should troubleshoot these issues as you would on any other installation of UniFi Controller.
Issues with the UniFi Controller software or its various dependencies might include not starting up, not listening on port 8443, exiting with a port conflict, crashing after startup, database errors, memory issues, file permissions, dependency conflicts, or the weather.
Feel free to open an issue for anything like this. Issues with the script might include problems downloading packages, installing packages, interactions with pfSense such as dependency packages being deleted after updates, or incorrect dependencies being downloaded. Step one is to determine whether the issue you’ve encountered is with this script or with the UniFi controller software.
The idea is to hold up system shutdown until the UniFi controller has a chance to exit cleanly.Īfter using this script to install the UniFi Controller software, check the UniFi controller documentation for next steps. The rc script will wait until the command received and the shutdown is finished. The the stop command takes a while to execute, and then the shutdown continues for several minutes in the background. Run this one-line command, which downloads the install script from Github and executes it with sh:.Log in to the pfSense command line shell as root.To install the controller software and the rc script: The pfSense updater will remove everything you install that didn't come through pfSense, including the packages installed by this script.īefore updating pfSense, save a backup of your UniFi controller configuration to another system.Īfter updating pfSense, you will need to run this script again to restore the dependencies and the software. Carefully consult Ubiquiti's release notes for upgrading considerations. Ubiquiti sometimes makes substantial changes, especially between major versions.
You should know that upgrading from earlier versions may be no small task. Features come and go, and behaviors change. Some involve database upgrades that can take some time. Updates, even minor ones, sometimes change things. Upgrading UniFi controllerĪt the very least, back up your configuration before proceeding.īe sure to track Ubiquiti's release notes for information on the changes and what to expect. It will be up to the package maintainers to keep the package up to date with the latest version of the software available from Ubiquiti.
To work around this, we can download the UniFi controller software directly from Ubiquiti during the installation process.īecause Ubiquiti does not provide a standard way to fetch the software (not even a "latest" symlink), we cannot identify the appropriate version to download from Ubiquiti programmatically. Challengesīecause the UniFi Controller software is proprietary, it cannot be built from source and cannot be included directly in a package. If you have already set up your system to use legacy BIOS, MBR partitons, and ZFS, then do not run this script. To avoid this problem, use UEFI mode if available, use GPT partitions, or use a filesystem other than ZFS. It appears that one of the dependency packages may cause this. Again, using this script on a system with an MBR formatted ZFS root volume will break your system. This script will destroy a legacy BIOS system booting from an MBR formatted ZFS root volume see #168. Be sure to check the forks for versions specific to other systems. The script is known to work on FreeBSD-based systems, including pfSense, OPNsense, FreeNAS, and more. From December 2020, this means the 6.x branch.
This project uses the latest branch from Ubiquiti rather than the LTS branch. The project provides an rc script to start and stop the UniFi controller, and an installation script to automatically download and install everything, including the rc script. The objective of this project is to develop and maintain a script that installs Ubiquiti's UniFi Controller software on FreeBSD-based systems, particularly the pfSense firewall. A script that installs the UniFi Controller software on pfSense and other FreeBSD systems Purpose