This article describes how to download and upgrade the UniFi Network Controller software on a UniFi Cloud Key (applicable to Cloud Key Gen 1 model, as well as both Gen 2 Cloud Key models) via SSH. Please see our Related Articles below to see information on how to upgrade the Cloud Key's firmware version.
NOTES & REQUIREMENTS: It is always best to make a backup prior to changing the UniFi Controller version. If you are changing release channels you may lose some statistics. This has only been seen in cases where the controller is downgraded between major release branches, nonetheless keep this in mind when making this change.
Table of Contents
- Steps: How to Upgrade the Cloud Key's Controller Version
- Removing UniFi Network from UCK-G2-PLUS (without removing UniFi Protect)
- Related Articles
Readers will learn how to change the controller version on the UniFi Cloud Key. This article will discuss how to download and install a controller version via SSH. This is specially useful when installing unreleased versions you will find in the beta Releases. For beta access, see this article: How To Sign Up for Early Access. For an update to the newest public release available, a simple upgrade via the WebUI is the easiest way to go, as described in this article: UniFi - How to Manage & Upgrade your Cloud Key.
Steps: How to Upgrade the Cloud Key's Controller Version
1. You will need to use the firmware's download link for step 4, so go ahead and locate it now. All stable releases can be found in https://www.ui.com/download/unifi/. In the Software section of the page, search for the most recent UniFi Network Controller for Debian/Ubuntu Linux and UniFi Cloud Key. Click the Download icon and when the pop up window appears, copy the URL.
If you are interested in a release that is not a Stable release, find the link in the corresponding beta Releases section. You will need special access to see these: How to Sign Up for Early Access. Once again, select Linux (Debian/Ubuntu), right click and select Copy Link Address.
2. Once you have the link to the .deb file, connect to your Cloud Key via SSH. If you aren't sure of the IP and are on the same L2 subnet then you could use the UniFi discovery tool to find it. Use the following article if you need help connecting via SSH: Intro to Networking - How to Establish a Connection Using SSH
3. After you are connected to the Cloud Key it is recommended that you change to the /tmp directory, by issuing:
Once you're in the tmp directory you'll see something like
root@UniFi-CloudKey:/tmp# in the console.
4. Issue the
wget command followed by the firmware download link you copied in step 1, to "grab" the file. Notice that in the example below, it is for a past firmware: version 5.10.17. You will need to replace the link in blue with the one you copied in step 1.
5. After you've downloaded the file, and are back in
root@UniFi-CloudKey:/tmp#, issue the following to "unpack" the firmware:
dpkg -i unifi_sysvinit_all.deb
6. Once it has successfully installed, and you are back in
root@UniFi-CloudKey:/tmp#, issue the following to remove the deb from the /tmp folder:
7. You can 'exit' from the SSH session now that the controller upgrade is complete with:
Removing the UniFi Network Installation from a UCK-G2-PLUS
If a user desires to reset only the Network Controller on the Cloud Key Gen 2 Plus without wiping the information from UniFi Protect, the steps below would allow for that to be accomplished.
ATTENTION: If possible, make sure that a backup of the Network Controller has been saved in a location other than the Cloud Key.
1. SSH to the IP or FQDN of the Cloud Key.
2. Use the following command to purge the install:
dpkg -P unifi
3. The purging process will take place, removing all UniFi Network Controller information.
4. To reinstall the controller, follow the steps in section 2.