Bugfixes
- Fix device adoption from toast link.
- Fix login issues for Admins without access to the Default site.
- Display Notes and Bandwidth profiles in New User Interface.
- Remove 'Forget Device' option for UDM and UDM-Pro.
Known issues
- Applying changes to UBB does not work in New User Interface, please use the old/classic user interface.
- L3 adoption of UBB does not work properly.
- Setups with a lot of clients and/or devices could trigger device disconnected alerts while backup is in progress.
Additional information
Please report any issues you encounter with this release using the Report Bug form.(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:
6.0.45 and earlier 6.0.x versions.
5.14.25 and earlier 5.14.x versions.
5.13.33 and earlier 5.13.x versions.
5.12.72 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.
- Controller updates may cause your adopted devices to reprovision after controller upgrades.
- 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 U6-Series devices is 5.29.0, 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=1.1.1.1', 'server=8.8.8.8', etc.
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).
- We support MongoDB 3.6 since 5.13.10, older controllers only support up to MongoDB 3.4.
Checksums
fc940c8866decf4d5a0284fa152a92b6 *UniFi-installer.exe
0537246a1913eda901a2f6c52b1fc055 *UniFi.pkg
6ad8e4da92f260852b417518d0d5bec9 *UniFi.unix.zip
fefdec13bdcdf3b20ad9fab3bce2a6bc *unifi_sysvinit_all.deb
601df32736f41e40a80a3e472450a3e1 *unifi_sh_api
------------------------------------------------------------------------------------------------------------------------
SHA256(UniFi-installer.exe)= 85643efc7c8c6aa3121cce22341b3dccfaf7ad496d5542903e74ad3232095544
SHA256(UniFi.pkg)= 02043547d321095de6bb4ce6bdf42c9535ef342a7963d9faa2ee7ec9c63bb355
SHA256(UniFi.unix.zip)= fad9edbd0392f722c379a8c10448803aceb23aa730d84d77dc95618ba67f7e7f
SHA256(unifi_sysvinit_all.deb)= 82d19b8772b018a8573932a2f89f0c116d98ed3a1ece22f45f973f773bc07ad3
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)
