Installing CT on Ubiquiti UniFi - Mac OSX

This guide's good for installing the firmware on any compatible Ubiquiti Unifi access point including:

  • Ubiquiti UniFi UAP V1
  • 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:

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

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.

Now change your IP address to 192.168.1.30, and click Apply once the changes have been made.

Now open the terminal on your computer.

Go to the location that you have the firmware saved (default is the Download folder) via the terminal by typing e.g:
cd Downloads

e. Make sure that you file is in there by typing:

ls

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 CT on your UniFi access point.

Now go ahead and add your box into your dashboard if you haven't already.  Read about adding a box here.