UniFi Network Controller 5.12.22


Important notes
Release stage: Stable
  • Cloud Email.*
  • Netconsole logging for USG.
  • New Settings.
  • Push notification support.
  • RADIUS DAS/DAC/CoA support.
  • Release channel selection for controller and firmware updates (New Settings).
  • Wi-Fi AI (New Settings).
  • Wi-Fi Schedule enhancements (New Settings).
*Cloud Email notes:
  • Enabled after successful Remote Access login. This will send (all) admin invites, alert/event, and password recovery emails via UniFi Cloud Access without requiring a STMP server to be configured. We plan to add support for password recovery without having Remote Access or SMTP configured in a future update.
  • If SMTP is configured then that will be used instead of Cloud Email.
  • Add encryption support for syslog and netconsole logging to controller (requires firmware 4.0.58+).
  • Add error messages for invitations.
  • Add experience panel headers.
  • Add per-port STP toggle to device property panel and profiles.
  • Add property panel experience graphs.
  • Add site-to-site data to VPN module.
  • Add subnet for IPv6 networks in Networks Table.
  • Add Wired experience score to client property panel.
  • Allow auto-upgrade for USG, USW, etc.
  • Allow multiple mirrored ports on a single switch.
  • Close column selector on first outside click.
  • Complete Hotspot 2.0R2 support for WFA certification.
  • Exclude disabled devices from reported network health on dashboard.
  • Filter all WiFi Metrics widgets by selected APs.
  • Improve Device Fingerprinting database.
  • Improve scan processing logic in Wi-Fi AI.
  • Improve scatter plot performance.
  • Improve token fetching/handling.
  • Improve wireless uplink detection in Wi-Fi AI.
  • In-Wall Networks/VLANs pre-population.
  • Limit auto speedtests to 2 per day.
  • Make encrypted cookie optional for the built-in Guest Portal.
  • Refactor High Performance Devices and add back to Auto-Optimize Network.
  • Reinstate green device icons for 1st gen UAPs.
  • Remove the sub nav from the New Settings nav item.
  • Show AP/port based on wired/wireless filter.
  • Show only APs in poor Wi-Fi element list in Dashboard status tool-tip,
  • Stop bundling Java with macOS package.
  • Store What's New last version in BE.
  • Update default HT/VHT modes for Wi-Fi AI; 20MHz for HT20 for 2.4GHz and VHT80 for 5GHz.
  • Update OUI table.
  • Use radio level satisfaction.
  • Use the same size for USW and USG port icons.
  • Add missing STP table head to port profile list.
  • Add wrapping to forget device form.
  • Fix and improve Device Fingerprint feature.
  • Fix authentication failure tracking.
  • Fix batch fingerprint console error.
  • Fix bug during initial setup which may cause Remote Access to be unavailable for 15 minutes.
  • Fix date range selector.
  • Fix Debug Terminal over WebRTC.
  • Fix DPI chart legend alignment.
  • Fix enable Remote Access error translation scope.
  • Fix external MongoDB startup issue.
  • Fix for payments tool-tip.
  • Fix invalid switch satisfaction scores.
  • Fix min RSSI settings not visible in device property panel.
  • Fix NPE for Download device info.
  • Fix NPE when removing Networks on site without a gateway adopted.
  • Fix possible NPE when restoring backup from command line.
  • Fix property panel WLANS on change UI glitch.
  • Fix reodering firewall rules (reported HERE, HERE, and HERE).
  • Fix settings console error.
  • Fix site switching over WebRTC.
  • Fix sorting by IP in Past Connections list.
  • Fix switch port disable function.
  • Fix topology scaling issue.
  • Fix untranslated country name in Speed Test modal.
  • Fix USG port form button wrapping.
  • Fix WebRTC logs fetching.
  • Fix wireless device list view filters.
  • Invalidate UI data.
  • Prevent reflow on AP Retry Rate scatterplot when tooltip is shown.
  • Reduce NanoHD log spam when wireless uplink is down.
  • Remove duplicate STP setting in port profile form.
  • Restore missing VHT160 channel width option.
  • Update certificates generated by controller to be compliant with new Apple rules.
(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.21 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).
2946ca2daa6b4f2ce5b76f12f0a74356 *UniFi-installer.exe
955bc6f6cd04db5a2fc2d633aabf02fb *UniFi.pkg
d172c2ad003fa59c022af4058103cd7a *UniFi.unix.zip
2388dde8f34d537cc9d69bc76ffb2318 *unifi_sysvinit_all.deb
601df32736f41e40a80a3e472450a3e1 *unifi_sh_api
SHA256(UniFi-installer.exe)= 4ae6ac01c465f590c4a2df9334ad86f2a45b818f088a5c675e733352f8fb33a9
SHA256(UniFi.pkg)= a7873c0434178997b780c95738ae8ba9b1912360536c3c1be2652f374ae0cc6d
SHA256(UniFi.unix.zip)= 1014760e0b79e434be668ca83becc0d40b531a12da6769811e5818338ecab2aa
SHA256(unifi_sysvinit_all.deb)= eb1ec1953df3995aabd474666e75b7532fd11e7c31256ed74bcbec4148b5ff4a
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_sh_api (shell library)


New UniFier
Ik gebruik Wifi AI nu iets langer dan 1 week. Prima nieuwe functionaliteit is mijn ervaring. Zijn er meer mensen die Wifi AI al gebruiken?
Screenshot 2019-12-05 at 07.42.59.png