How to Upgrade a UniFi Controller on Linux

How to Upgrade a UniFi Controller on Linux


I have used the Ubiquiti UniFi product since it first came out and have watched the evolution with excitement because I believe the AP/Controller concept is the future of indoor wireless.

Ubiquiti has done it in their usual fashion by making powerful products affordable and UniFi is no different. With UniFi, you need a UniFi controller in place to fully utilize the statistical and maintenance features that make it so different than anything else at this price point.

That being said, to truly get the controller cost down, you have to use Linux to avoid the Microsoft bloat and licensing costs. If you aren't using Debian or Ubuntu and have decided to roll your own with some other flavor of Linux like Centos, upgrading the UniFi software may not be totally obvious from the documentation so I will help you out.

Assuming you are running Centos. First, everything should be living in /usr/lib/UniFi. That directory should look like this:


The important directory is the data directory, everything else is installed with the upgrade. Therefore, make a backup of the data directory however you wish, but I recommend using tar like this:

tar -zcvf data.tar.gz /usr/lib/UniFi/data


This will create a tar.gz file in the /usr/lib/UniFi directory. Next you need to download the new UniFi binaries from Ubiquiti. 

Because you have to accept the terms of their license agreement, using wget isn?t an option here so download to your laptop and then scp or ftp the zip file to your controller and place in the /usr/lib directory. Change the current UniFi directory to something else like this:

mv UniFi UniFi-old


Then, unzip the new version in the directory /usr/lib. it should unzip itself as a directory named ?UniFi?.

cd /usr/lib


When the unzip operation is done, change to the newly created directory and rename the data directory like this:

cd /usr/lib/UniFi
mv data data-dist


Then move your data tar file back to the proper directory:

mv /usr/lib/data.tar.gz UniFi


Finally, restore your valuable data:

tar -zxvf data.tar.gz


Unzip the file like this:

tar -zxvf data.tar.gz


At this point you should be able to start the unifi controller and have an upgraded version with your old data still intact. Good luck!

    • Related Articles

    • Ubiquiti Unifi UAP-Pro 5GHz Channels Supported

        Ubiquiti Unifi UAP-Pro ? What 5GHz Channels Are Supported? I recently was asked by a customer to assist with planning a Ubiquiti UniFi installation in a large church auditorium. The customer wanted to be able to support the maximum number of users ...
    • Setting up QOS for VoIP on a UniFi Security Gateway

      Activating the Smart Queue UniFi Security Gateway offers a Smart Queue option based on Fair Queuing and Codel which prioritizes traffic and reduces delays when the router/bandwidth becomes overloaded. Activating this option will give priority to all ...
    • How to Upgrade Ubiquiti Firmware

        Firmware Upgrade process Contents: This guide describes the Firmware Upgrade process of AirOS. Requirements: UBNT devices to upgrade. Ethernet Cable. A PC or Laptop always configured to access the units (es. [1] ). IMPORTANT! Do not switch off, do ...
    • How to Upgrade MikroTik Software

        It is suggested to always keep your RouterOS installation up to date, MikroTik always keeps adding new functionality and improving performance and stability by releasing updates. RouterOS versions are numbered sequentially, when a period is used to ...
    • Upgrading Baicells LTE UE's and eNB's

      For the base station: To upgrade the firmware, please follow the following steps: 1. Log into the eNB's web gui 2. Go to "System" 3. Go to "Upgrade" 4. Click "Choose file" and choose the firmware file. 5, Click "Upgrade Now". For UE: Log into CPE ...