This article describes how to change the firmware on UniFi devices, including instructions on the more common upgrade to the most recent release via the GUI, as well as manually changing the firmware version, be it to an unreleased version or reverting to an older firmware version.
NOTES & REQUIREMENTS:
If you are planning on using a different firmware version than what comes bundled with the controller version, make sure you disable Automatic Upgrades in the controller first.
Table of Contents
How to Change the Firmware Via the Controller Web UI
Applicable for: UniFi AP/UniFi Switch/UniFi Security Gateway/UniFi Security Gateway Pro
For unadopted APs and Switches, you will see an upgrade button in the Devices tab of the Controller. You will be able to use this option even before adopting the device, this will be specially useful if you are experiencing issues adopting a device.
NOTE: The upgrade button does not work for USG and USG-PRO-4.
For any adopted UniFi device you can easily upgrade or change the device firmware from the device Properties window. In the Devices tab click on Name/MAC address of the AP to expand the Properties panel. Select the Configuration tab > Manage Device > Custom Upgrade.
In this section you can enter a link that points to the new firmware version. Firmware links can be found on our official download page, HERE, and also within the release notes or firmware blog posts HERE.
NOTE: When using a link to a firmware binary on our CDN, the UniFi device will need to be able to properly resolve the host via DNS/access the WAN. The custom upgrade would also work for a locally hosted FTP or HTTP server.
How to Disable Automatic Upgrades
When you enable the option to "Automatically upgrade AP firmware" all access points will upgrade the moment you upgrade the Controller's software version. If you are changing the firmware of one of the devices to one other than the released version, you will want to disable the Automatic Upgrades to avoid it rolling back to that public release.
1. To do so, go to Settings > Site
2. Make sure the checkbox for Automatically upgrade firmware is left unchecked. Wording might be slightly different depending on the Controller version.