Overview
Readers will learn how to change the UniFi Controller version on the UniFi Dream Machine (UDM or UDM-Pro) and UniFi Cloud Key models (UCK-G2, UCK-G2-PLUS and UC-CK) via SSH.
- Applicable to the UniFi Dream Machine (UDM/UDM-Pro) and UniFi Cloud Key models (UCK-G2, UCK-G2-PLUS, UC-CK).
- See the UniFi - UDM/UCK: How to Reset the UniFi Controller to Factory Defaults help center article for more information on how to reset the UDM and UCK models to factory defaults.
- Create a backup using the UniFi - How to Create and Restore a Backup help center article and export/save your backup configuration to a separate device before following this article.
Table of Contents
Introduction
The software version of the UniFi Controller that is running on the UDM (UniFi Dream Machine) or UCK (UniFi Cloud Key) models can be upgraded or downgraded using SSH. This feature is especially useful if you want to manually change the software a specific Stable or Beta version.
The latest UniFi Controller versions can be found in the Software Releases section on the Ubiquiti Community. If you are interested in Beta releases, then it is necessary to log in with your Ubiquiti Community user account that has Early Access enabled.
Changing the UniFi Controller version using SSH
Use the table below to select your model and follow the steps to change the UniFi Controller version:
1. Navigate to the Ubiquiti Downloads page to obtain the UniFi Controller firmware download link.
2. The latest UniFi Controller releases are listed in the Software section.
3. Expand the UniFi Network Controller for Debian/Ubuntu Linux and UniFi Cloud Key option and select download.
4. Accept the EULA and copy the firmware download URL. An example URL is:
https://dl.ui.com/unifi/x.xx.xx_version/unifi_sysvinit_all.deb
5. Open a SSH session using your favorite SSH/Telnet client program (for example PuTTY or the macOS/Linux Terminal).
6. Access the UniFi OS shell:
unifi-os shell
7. Navigate to the /tmp directory:
cd /tmp
8. Verify if there are any previous installation files present in the directory and delete them if applicable:
ls -l
rm unifi_sysvinit_all.deb
9. Use the curl command with the previously copied link to download the UniFi Controller installation file and store it in the /tmp directory.
10. Replace https://dl.ui.com/unifi/x.xx.xx_version/unifi_sysvinit_all.deb with the previously copied URL.
curl -o "unifi_sysvinit_all.deb" https://dl.ui.com/unifi/x.xx.xx_version/unifi_sysvinit_all.deb
11. Wait for the firmware download process to complete and install the new version using the dpkg command:
dpkg -i unifi_sysvinit_all.deb
12. Wait for the installation process to complete and remove the unifi_sysvinit_all.deb file afterwards.
rm unifi_sysvinit_all.deb
1. Navigate to the Ubiquiti Downloads page to obtain the UniFi Controller firmware download link.
2. The latest UniFi Controller releases are listed in the Software section.
3. Expand the UniFi Network Controller for Debian/Ubuntu Linux and UniFi Cloud Key option and select download.
4. Accept the EULA and copy the firmware download URL. An example URL is:
https://dl.ui.com/unifi/x.xx.xx_version/unifi_sysvinit_all.deb
5. Open a SSH session using your favorite SSH/Telnet client program (for example PuTTY or the macOS/Linux Terminal).
6. Navigate to the /tmp directory:
cd /tmp
7. Verify if there are any previous installation files present in the directory and delete them if applicable:
ls -l
rm unifi_sysvinit_all.deb
8. Use the wget command with the previously copied link to download the UniFi Controller installation file and store it in the /tmp directory.
9. Replace https://dl.ui.com/unifi/x.xx.xx_version/unifi_sysvinit_all.deb with the previously copied URL.
wget https://dl.ui.com/unifi/x.xx.xx_version/unifi_sysvinit_all.deb
10. Wait for the firmware download process to complete and install the new version using the dpkg command:
sudo dpkg -i unifi_sysvinit_all.deb
11. Wait for the installation process to complete and remove the unifi_sysvinit_all.deb file afterwards.
rm unifi_sysvinit_all.deb
Related Articles
UniFi - How to Create and Restore a Backup