UniFi 5.2.9 is our newest official General Availability Release for UniFi wireless AP (UAP), routing (USG), and switching (USW).
**How to play safe?**Make sure you always do a backup before any updates, especially if you plan to upgrade your existing installation.
For people who are migrating from v3, there’re many changes to APIs and it’s not backward compatible. You may need to update the shell library (unifi_sh_api) and/or your customized portal/external portal code.
Windows users must have x64 Java installed as we only support 64 bit webRTC library. Please see HERE and download the missing version (64bit offline Windows install package).
For hotspot management console, make sure you have bookmark the URL with site ID (i.e. x66cipn3, or whatever random string is generated for that site). For example:
For Debian/Ubuntu users, please update your APT source (see HERE).
unifi-beta/unifi-rapid are obsoleted. The old repo has been removed.
use ‘unifi5’ in your source file, instead of ‘stable’ or ‘unifi4’
On Linux you can now use Oracle Java instead of OpenJDK (if desired). The current init script does not reflect this. To properly define the JAVA_HOME location on your Debian/Ubuntu installation you should create a default file to define the path. This method is persistent across controller upgrades. Something like the following will work (change JAVA_HOME path as needed):
echo “JAVA_HOME=/usr/lib/jvm/java-8-oracle” | sudo tee /etc/default/unifi
You can no longer manage/control UniFi VoIP devices from the UniFi controller. Please use the UniFi VoIP controller for UVP products. The latest release as the time of this post is found HERE.
You can no longer toggle the VoIP port on the USG (UGW3). It needs to be enabled prior to upgrading/using v5, otherwise you will not be able to control it. If you rely on using the VoIP port then you may want to stay on v4.8.19. Currently it can only be configured as a secondary WAN in v5, but we will be expanding the functionality so it can be used as either a secondary WAN or LAN (LAN will be fully configurable).
You cannot re-use a VLAN ID for dynamic VLAN if it is set as a static value for another SSID on the same AP. So, if I have a SSID set to use VLAN 10, I cannot use VLAN ID 10 for RADIUS controlled VLAN users as those users will not get an IP.
Cloud Access feature in this release is not supported on Linux/ARMv6 architecture (for exmaple, Raspberry Pi 1). If you have problem starting controller on this platform, please remove the native library:
sudo rm /usr/lib/unifi/lib/native/Linux/armhf/libubnt_webrtc_jni.so
Smart Queue QoS is similar to the implementation as in EdgeOS (see HERE). Please note that DPI will not work when using Smart Queue QoS, as traffic will not be offloaded. It’s also worth noting that maximum throughput will be affected when using Smart Queue QoS, as traffic is not offloaded. There are some rough guidelines in the article linked above.
- If you are coming from an earlier release, and aren’t familiar with the changes in v5, please see our initial release post HERE.
- Do note that DFS channels can not be used for wireless uplink as of this release. Please use non-DFS channels if you need to use wireless uplink on dual band UAPs.
- On 5G/dual band UAPs, wireless uplinks will only work on channels 36 or 149. This bug has been present for a while (in the 3.7.x firmware branch). As of 10.07.16, this has been fixed internally, but we are testing the fixes. They haven’t been released anywhere yet.
- You cannot adopt USG unless it is on a newer firmware, so it’s recommended to use the firmware bundled with this release.
- If your USW shows as disconnected after firmware upgrade you can perform a set-inform (similar to L3 adoption, see HERE) or you can powercycle the USW. Either method should restore the device to a connected state.
Add Static Routes and Firewall rules (beta) in Settings.
Add Auto Backup in Settings.
Add Remember me to login page (extend session timeout to 24h).
Device details: Add Channel Utilization.
Added minimum rate and beacon control for UAPs
Added memory usage and load average to AP and switch details
Added the ability to config gateway, switch and AP LED on/off state
Added LED config option to device General config form
Added smart banner for iPhone/iPad devices.
Add DPI category/app/client views in Statistics.
Allow overriding angular Hotspot Portal files.
Controller Bugfixes/Changes from 5.0.7:
- Disable Custom Upgrade when Auto Upgrade is on.
- Fix wrong number of devices in channel occupancy graph on Dashboard.
- Fix select maps dropdown.
- Store less, fetch more approach to insights, alerts, events, settings, admins.
- UI performance improvements.
- Add configurable list of languages in Hotspot Portal.
- Store less, fetch more approach to networks, site health, known clients and other insights data.
- Allow admin accounts to login to hotspot as a fallback.
- Throughput graph: display correct value of avg throughput in download tooltip.
- Added alias config to configuration of phone property panel.
- Fixed for printing vouchers over WebRTC.
- Backup settings only without historical data.
- Added latency formatting filter.
- Added warning to confirm modal for upgrade/update.
- Improved WebRTC handling.
- Quick Stats: prevent displaying arrows without values.
- Fixed “view all” for known clients and neighboring APs.
- Map coordinates stored as floats instead of strings.
- Added browser warning for non-Chrome/Firefox browsers.
- Pending changes label more verbose.
- Added warning before closing all property panels if any docked panels have changes.
- Fix client uplink sort to account for switch port.
- Expose SDN log level.
- Added SV and NL languages for hotspot portal.
- Added handling of events pushed from backend.
- Added TURN support for debug terminal.
- Improved RF environment.
- Added Polish translations.
- Fixed editing image maps.
- Added sorting hotspot packages.
- Fixed sorting PoE power.
- Added RADIUS port for network configuration.
- Added sites overview device list.
- Added mirroring port and WLAN group ZH tooltips.
- Transition switch port diagram between PoE and blocking icons.
- Split switch icons into PoE into PoE+ and 24V PoE.
- Update Debian dependency, to allow Oracle Java (this allows you to remove OpenJDK, if desired. This can save space on CK).
- Add UK to countries supported by Stripe,.
- Added shorter time filter options for neighboring AP insight.
- Fixed INFORM_ERROR state and allow adopting in this state.
- Fixed http hostname lookup during app load.
- Setting default autobackup expression to monthly.
- Added preference for disabling websocket.
- Fixed case when there is no selected map.
- Added bandwidth info of neighboring AP, and grey out RSSI if too old.
- Changed property panel adopt icon to blue.
- Improved stability of WebRTC connections.
- Added new rfscanning state.
- Added model with data retention update.
- Enabled autobackup during initial setup.
- Added pt_PT language to hotspot portal.
- Do not allow read-only users to create vouchers.
- Added search functionality to site overview modal and full page.
- Added alert count to site overview pages.
- Show more than just “Enabled” for WLAN overrides.
- Renamed state from “Pending approval” to “Pending adoption”.
- Adopt button in panels use reverse and round action icon style.
- Show backend version in controller settings.
- Added performance improvements on device page.
- Added check device firmware update button to settings.
Controller Bugfixes/Changes from 5.2.7:
- Fix L3 adoption issue.
Firmware Changes from 3.7.5/4.3.21:
[UAPG2] Enable DFS for supported countries.
[UAPG2] Fix a bug with Legacy mode that left it always on, regardless of setting.
[UAPG2] Fix rate limiting on non-guest VAP.
[UAPG2] Fix LAN lockup issue with AC-Lite/LR when connected to some 100Mbps switches.
[UAPG2] Guest isolation (ap_bridge) update.
[UAPG2] Add arp to busybox, previously was missing.
[UAPG2] Add netconsole support.
[UAP] Several changes to HW/SW retry logic
[UAP] Disable ATF in default config, for models that have a configurable setting.
[UAP] Fix client TX stats showing as double RX stats on 2.4G radio.
[UAP] Change default DTIM to 3.
[USW] Add backend support for LLDP-MED.
[USW] Change FASTPATH local telnet access to port 23, and add warning that changes are not persistent.
[USW] Update base to ES 1.5.0.
[USW] Fix bug with remote terminal triggering 100% CPU usage.
[USW] Fix US-8-150W flipped PoE LED after power cycle.
[USG] Patch a couple of critical security vulnerabilities.
Note that the bundled firmware links for UAP and USW are HTTP as currently HTTP links are required for custom upgrade via the controller UI, or firmware upgrade via CLI. You can update the link to HTTPS if you desire, but it will not work for either of those firmware upgrade methods.