Installing Cucumber on Ubiquiti UniFi - Windows
This guide's good for installing the firmware on any compatible Ubiquiti Unifi access point including:
- Ubiquiti UniFi UAP
- Ubiquiti UniFi Pro
- Ubiquiti UniFi LongRange
- Ubiquiti UniFi Outdoor
- Ubiquiti UniFi Outdoor +
NOTE: If you are installing a UniFi AC firmware, please follow this guide instead.
There's two ways to flash the devices. You can use TFTP which is a bit nerdy. Or you can use the Unifi controller and ssh.
Please note, flashing over SSH may not work with UniFi version v3.2.7 and above. Doing so may brick the device. If this happens you can recover the device by flashing it over TFTP.
You can also use this guide to revert to the original firmware. All you need to do is download the firmware from your Ubnt controller and follow this. The reverting firmware guide is here.
Option One - TFTP
There are two ways of installing the firmware on a UniFi access point. This is option one and involves physically resetting the unit. If you don't have the access points in front of you use option two.
You can install the Cucuber firmware on the Ubiquiti UniFi Pro, Ubiquiti UniFi UAP, Ubiquiti UniFi UAP LongRange and Ubiquiti UniFi Outdoor.
You will need:
- A computer with ethernet ports
- A UniFi access point
- 2 x Ethernet cables
- A download of the Cucumber firmware (Follow this guide to download the firmware)
- A download of tftp2
Let's get flashing...
1 - Connect your access point to your PC. Connect one end of the Ethernet to the LAN port on the PoE adapter and the other end to the Ethernet port on your computer.
2 - Plug the second Ethernet cable into the other port POE adapter. The other end of the cable will plug into your UniFi access point.
3 - You will now need to put your AP into recovery mode. As you connect the Ethernet cable to your access point to power it up, press and hold the restart button using a sharp point (e.g. a paperclip) until the lights on the box cycle between the following colours:
Unifi Outdoor - Green > Orange > Off
Unifi Pro - Blue > White > Off
Unifi Outdoor+ - Blue > White > Off
Upload the firmware
Go to your Windows Control Panel and Click on Network and Internet (Names may vary depending on Windows Version).
Click on Network and Sharing Centre (Names may vary depending on Windows Version)
Click on Change Adapter Settings
Right click on your Ethernet adapter and select properties
Select Use the following IP addresses, input the IP and Subnet and click OK
Download TFTP2.exe from here and run it. In the Server field add 192.168.1.20 (this is the IP of the Ubiquiti device in failsafe mode)
In the File row, click on the 3 dots button and select the firmware downloaded from Cucumber Tony. Then Click Upgrade.
If everything is set up correctly and the box is in failsafe mode, the status bar should get to full.
The lights on the box will now flash as the firmware installs and the box updates itself. When the lights stop flashing and turn solid, the install is complete.
Option 2 - Using the Unifi Controller and SSH
Please note, flashing over SSH may not work with UniFi version v3.2.7 and above
cd /tmp wget http://FIRMWARE-URL-PROVIDED-BY-CUCUMBER
fwupdate.real -m FIRMWARE-NAME.bin -d