Installing Cucumber on Ubiquiti UniFi - Mac OSX
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 guide. 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 Cucber firmware on the Ubiquiti UniFi Pro, Ubiquiti UniFi UAP, Ubiquiti UniFi UAP LongRange and Ubiquiti UniFi Outdoor. If you have bought your box from PolkaSpots you don't need to install the firmware - we've already done this for you.
You will need:
- A computer with ethernet ports
- A UniFi access point
- 2 x Ethernet cables
- Access to the terminal on your PC
- A download of the Cucumber firmware (Follow this guide to download the firmware)
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
On your computer, set your IP network settings to 'manual'.
Go to System Preferences> Networks> select Ethernet on the left and on the setting for IPV4 select 'Manually' from the drop down menu. You will need to unlock the padlock on the bottom left to do this.
e. Make sure that you file is in there by typing:
You should see the name of your firmware image with a '.bin' at the end
Copy the entire name to your clipboard, including .bin
Type in your terminal:
tftp 192.168.1.20 bin trace put FIRMWARE-NAME.bin
Replace FIRMWARE-NAME.bin with the name of the file you previously downloaded
Press return. Lines of code should appear rapidly in your terminal.
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.
You have successfully installed Cucumber on your UniFi access point.
Now go ahead and add your box into your dashboard if you havent already.
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-POLKASPOTS
fwupdate.real -m FIRMWARE-NAME.bin -d