Unifi controller update and installation

UniFi Installation and Upgrade on Windows

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.
cd /tmp/
  • 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.
wget Paste-URL-here
 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 dpkg to 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: sudo service unifi start
To stop the UniFi service: sudo service unifi stop
To restart the UniFi service: sudo service unifi restart
To see the status of UniFi service: sudo service unifi status




Leave a Comment