The process of unifi controller update and installation is somewhat similar but there are few points which are needed to be considered.
NOTES & REQUIREMENTS: This article covers installation and upgrades on macOS, Windows and Windows Server and Debian-based Linux (Ubuntu, Mint, and others). For instructions specific to the UniFi Cloud Key Controller, please see this article.
Finding your current controller version and latest available controller version
To upgrade your controller version, you must know your current controller version. Yes. Its important. You can not jump from a very older controller version to the latest available as per release notes of unifi controller version.
You can find the information about the release notes and announcements here.
To check the available latest version of the cpntroller you need to check the software section of the downloads page of unifi here
Always check the release notes
You must aware about the disaster happened when unifi released their 5.10.23 controller version. The device firmware should be in the range of the 4.0.x in order to manage them from the latest controller version. But some of us did not check release note ( Huh! who does that). and updated the controller version without updating the firmware on the devices. Then all they left with updating each device by SSH into it. So always check release notes.
Update device firmware and then update unifi controller
Yes, Always upgrade you adopted device in the controller and then proceed with unifi controller update.
Take a backup of the controller
Always take a backup of the controller. It’s for the best practice and it will help you to keep your configuration safe.
UniFi Installation and Upgrade on Debian-based Linux
|CLI: Access the command-line interface (CLI). You can do this by using an SSH client to a Linux host or by opening the console from the Linux GUI.|
- Go to the download page then navigate to the software section
- Find the appropriate version of the controller and then click on download followed by a click on COPY URL
- SSH or open a console to the Controller host.
- Switch to the /tmp/ directory.
- Download the .deb file with
wget. This is where the copied URL comes into play. Hit enter after the URL copied on step 4 is pasted.
|NOTE: At this point, the .deb file will download to the /tmp/ directory. How quickly this completes is based on the host’s throughput to the internet.|
- After the download completes, use
dpkgto unpack the .deb file and install the new Controller version.
sudo dpkg -i unifi_sysvinit_all.deb
NOTE: The filename referenced above should be used. If it is not, the file name can be referenced from the
wget command output. Remember to be in the /tmp/ directory when running the
dpkg command or it will look for the file in the /home/ directory. During this time the UniFi Network Controller is unable to process any requests. Client data will still pass through the devices.
- When Upgrading: The installer will run through the process of upgrading the UniFi Network Controller software. A prompt will come up asking if you have a sufficient backup on hand. Select yes if you do or no if you do not.
- When Installing: A message about dependency problems may appear. Type in the following command and hit enter:
sudo apt-get install -f
- After the process completes the command prompt will return to entry. The controller software should be upgraded or installed successfully at this point.
- To access the Controller open a browser window and navigate to:
- If the Controller service is running the software should prompt with a webpage.
|User Tip: Other commands that might be useful are:|
To start UniFi if the webpage prompt does not appear:
To stop the UniFi service:
To restart the UniFi service:
To see the status of UniFi service:
UniFi Installation and Upgrade on Windows