We've made it much easier to change device firmware via the controller web UI. For any unadopted device, you will have the upgrade option which can be performed before you adopt the device. This may help if you experience issues adopting a device.
For any adopted UniFi device you can easily upgrade or change the device firmware from the device properties window. This is found under either under Configuration>Custom Upgrade or Configuration>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.
Changing device firmware via SSH
There are a couple of ways to do this. There is the method where the UAP will pull the firmware from the controller and perform the upgrade. There is also a local upgrade, where it runs from the UAP itself. I will detail both methods within this article.
To perform a local update, the firmware.bin needs to be renamed to fwupdate.bin, then copied to /tmp on the UAP.
So, what you need to do is copy the file from the appropriate directory of the controller. You can get the "version" from the table below, match up the appropriate folder per model of UAP.
For Linux you would:
For Mac you would:
So, for example, in Linux, if I wanted to copy 3.2.1 binary to a standard UAP for local upgrade I would:
The local path to the firmware binary could vary, depending on if it's bundled with the controller or if you downloaded a special binary.
Windows users need to copy the file via WinSCP, or MobaXterm (there are other programs too, PSCP, etc.). I would recommend renaming it after you copy it to /tmp/ directory though (as you want to leave the local file as firmware.bin).
Then connect via SSH and issue the appropriate command to initiate a local upgrade.
syswrapper.sh upgrade2 &
Make sure that you use the appropriate firmware binary for the appropriate device. This method is useful for some test firmwares which may not include wget. You may have other reasons to do this method too, like upgrading a certain UniFi device to a different firmware version without changing the existing controller version.
USG/USG-Pro does support local upgrade, but you may want to use upgrade.tar for the file name. You will have to place the upgrade file in a writable directory, so may be best to use /home/username/ (replace username with the admin username). You need to run the command elevated. Assuming you're in the home directory, and the file is named upgrade.tar then you would issue 'sudo syswrapper.sh upgrade upgrade.tar'Determining Firmware Version
As of 4.8.14 we started hosting USG firmware on our CDN, but UAP and USW firmware is still bundled with the controller. You can find the firmware within the following folders:
Vista/7/8/10: C:\Users\username\Ubiquiti UniFi\dl\firmware
XP: C:\Documents and Settings\username\Ubiquiti UniFi\dl\firmware
Please reference the table below to match the firmware folder with the device model(s).
|BZ2||UAP, UAP-LR, UAP-OD, UAP-OD5|
|U7E||UAP-AC, UAP-AC v2, UAP-AC-OD|
|US24P250||US (all current models, with the exception of the US-16-XG)|
These are some user cases that might be helpful to other readers, if you have something you would like to add to this section, don't hesitate to send us an email at firstname.lastname@example.org.