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.

Getting Started

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:

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 UAP - Green > Orange > Off 
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

1 - Open the terminal on your computer.
2 - Type in the terminal:
ssh ubnt@ip-address
	
Sometimes the default user may not be ubnt - it may be admin or whatever you've set up on the UniFi controller.
The default password is ubnt (again, you may have changed this).
3 - After logging in to your access point type:
cd /tmp wget http://FIRMWARE-URL-PROVIDED-BY-CUCUMBER
	
To get the firmware URL, follow the normal steps to download the firmware, but rather than left clicking on the final step to download it, right click and copy the URL.
Please ensure that you change the beginning to http otherwise you will get certificate errors.
4 - Make sure that you have downloaded the image by typing in the same window:
ls
	
You should see the name of your firmware - for example "firmware.bin". Please note, this will be different depending on what firmware version you download.
Please make a note of it, you will need it for the next step.
5 - Now type the following into the terminal:
fwupdate.real -m FIRMWARE-NAME.bin -d
	
Replace FIRMWARE-NAME.bin with the name of the file you previously downloaded
The installation should now begin. Please do not disconnect your box from electrical supply.
6 - 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 the Cucumber firmware. 
Now go ahead and add your box into your dashboard if you haven't already.  Read about adding a box here.