Release Candidate UniFi Network Controller 5.12.19

  • Beste gast, registreer een account en krijg zo volledig toegang tot het UniFi forum!


1 feb 2018
Important notes
Release stage: Release Candidate


  • Regenerate self-signed certificates for existing installations to meet Apple's new rules (see Apple's article HERE).*
*This only regenerates certificates that were originally generated by the controller itself. This change is different from the previous in that this works for existing installs whereas the previous fix only worked for new installations.
(Recommended) - Create an up-to-date backup before upgrading your controller in the event any issues are encountered.
  • Existing UniFi Network controllers must be on one of the following versions in order to upgrade directly to this version:
5.12.18 and earlier 5.12.x versions.
5.11.52 and earlier 5.11.x versions.
5.10.27 and earlier 5.10.x versions.
5.9.33 and earlier 5.9.x versions.
5.8.30 and earlier 5.8.x versions.
5.7.28 and earlier 5.7.x versions.
5.6.42 and earlier 5.6.x versions.
Most earlier versions are also supported for direct upgrade, going back to 3.1.0.

  • An updated/current version of Java 8 must be installed on the system hosting the controller software. Java 9 and later are not yet supported.
  • As of UniFi Network controller 5.9, if using Cloud Access, the host system/device requires outbound 8883/tcp to be open/unrestricted. Find up-to-date port requirements here.
  • Minimum supported device firmware for UAP/USW is 4.0.9, and for USG it's 4.4.34.
  • If you have any 'service dns forwarding options' configuration defined in config.gateway.json, it will overwrite the provisioning of statically defined name servers, leaving you with no DNS. Either remove the 'service dns forwarding options' portion of config.gateway.json, or add additional 'options' lines defining name servers, such as 'server=', 'server=', etc.
  • PoE passthrough control was implemented for UAP-IW-HD which means that the default for PoE passthrough is now disabled instead of enabled. If you were using this feature before then you will need to re-enable it via the device property panel.
Microsoft Windows specific:
  • Users running 64-bit Windows should only have 64-bit Java installed. If you have 32-bit Java installed then we recommend uninstalling it.
macOS Specific:
  • We stopped bundling Java as of UniFi Network 5.11.47. If you're installing that release or later please make sure you have manually installed a current release of Java 8 beforehand. Only the Java Runtime Environment (JRE) is required.
  • Oracle JRE 8 offers the simplest path as it will simply "just work" without requiring any changes. We may investigate alternative JVMs and update this message accordingly.
Debian/Ubuntu specific:
  • For Debian/Ubuntu users installing via our repo, please update your APT source (see HERE).
  • Currently we only support MongoDB 3.4. We're working on updating support before end of life this fall. We have instructions for Ubuntu users in our HC article HERE (see section 2.2).
541078a6c989bfed804c052e01c198d0 *UniFi-installer.exe
8f30469c17821be3e6ec44fb453d8d42 *UniFi.pkg
1ad017da8f2eb2d2e0f74d84a3421152 *
d3d5d6ca50bfec2e6e3bc02be8f7f26e *unifi_sysvinit_all.deb
601df32736f41e40a80a3e472450a3e1 *unifi_sh_api
SHA256(UniFi-installer.exe)= 77be7479480af64fa289968a9d98614e9d8745c71b82c65dbb71ab93a026b56f
SHA256(UniFi.pkg)= ff5cfba935328e52513fa496debb3b6e0d133fb6b97db5e714b6b7ccac7a83b8
SHA256( e74a8207e9578bae67d0791fd55c826f501056a0a9126743416381c1d8cb730e
SHA256(unifi_sysvinit_all.deb)= 5016c3f041aebcd7f8fffb4f52a1f11671f9943f7033f5d0c5409bd4e58dffa9
SHA256(unifi_sh_api)= 1791685039ea795970bcc7a61eec854058e3e6fc13c52770e31e20f3beb622eb

Download links
UniFi Controller for Windows
UniFi Controller for macOS
UniFi Controller for Debian/Ubuntu and UniFi Cloud Key
UniFi Controller for unsupported Unix/Linux distros *** DIY / Completely unsupported ***
unifi_sh_api (shell library)