How to upgrade the Omada Software Controller
07-24-2024Contents
Omada Software Controller for Windows
Omada Software Controller for Linux (Deb)
Omada Software Controller for Linux (tar.gz)
This article provides configuration guidance for upgrading the Omada Software Controller installed on Windows systems and Linux systems.
- Omada Software Controller V5
This article describes how to upgrade the Omada Software Controller installed on Windows systems and Linux systems.
Omada Software Controller for Windows
After a new version of the software is released on our official website, you can upgrade your Controller.
The upgrade steps below will use the Omada Software Controller installed on a Windows 10 system as an example.
Step 1. Obtain the latest version of the software package. Choose a method below:
- Via pop-up window: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. The upgrade pop-up window will automatically appear in the top right corner when a new version is detected. Click Download to download it.
- Check for Updates: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
In the pop-up window with the Release Notes, click Download to obtain the latest software version.
- Manual Download: Visit Download for Omada Software Controller | TP-Link to obtain the latest software version.
Step 2. Close the Controller and unzip the software package.
Close the Controller, unzip the software package you obtained, and use the .exe file in it to perform the upgrade.
Note: Before upgrading, we strongly recommend that you use the Backup function to back up all data to avoid data loss.
Step 3. Upgrade the Controller.
In the upgrade window, click Next.
The program will detect the old version of the Controller and ask if you want to upgrade. If you want to upgrade, click Yes to start the upgrade; if you want to cancel the upgrade, click No.
Wait until the upgrade process is complete.
Click Finish, and the installer window will close.
Omada Software Controller for Linux (Deb)
After a new version of the software is released on our official website, you can upgrade your Controller.
The upgrade steps below will use the Omada Software Controller installed on an Ubuntu 20.04 system as an example.
Step 1. Obtain the latest version of the software package. Choose a method below:
- Via pop-up window: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. The upgrade pop-up window will automatically appear in the top right corner when a new version is detected. Click Download to download it.
- Check for Updates: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
In the pop-up window with the Release Notes, click Download to obtain the latest software version.
- Manual Download: Visit Download for Omada Software Controller | TP-Link to obtain the latest software version.
Step 2. Installing the Deb file using dpkg.
After obtaining the latest version of the software package (.Deb file), use the following command to install the file.
sudo dpkg -i Omada_SDN_Controller_v5.x.y.z_Linux_x64.deb
After entering the command, if the Controller is still running, the installation program will automatically stop it. If the stop fails, please manually stop the Controller using the sudo tpeap stop command.
Note: Before upgrading, we strongly recommend that you use the Backup function to back up all data to avoid data loss.
Step 3. Upgrade the Controller.
After the Controller is successfully stopped, the installation program will display the upgrade confirmation window. Use the arrow keys to choose the options and press Enter to confirm. If you select Yes, the upgrade will continue.
Wait until the upgrade process is complete.
The Controller will automatically start up.
Omada Software Controller for Linux (tar.gz)
After a new version of the software is released on our official website, you can upgrade your Controller.
The upgrade steps below will use the Omada Software Controller installed on an Ubuntu 20.04 system as an example.
Step 1. Obtain the latest version of the software package. Choose a method below:
- Via pop-up window: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. The upgrade pop-up window will automatically appear in the top right corner when a new version is detected. Click Download to download it.
- Check for Updates: Connect the PC where the Controller is installed to the internet and log in to the Controller with a Main Administrator account. Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
In the pop-up window with the Release Notes, click Download to obtain the latest software version.
- Manual Download: Visit Download for Omada Software Controller | TP-Link to obtain the latest software version.
Step 2. Unzip the software package.
After obtaining the latest version of the software package (.tar.gz file), use the following command to unzip the file.
tar -zxvf Omada_Controller_v5.x.y.z_Linux_x64.tar.gz
Note: Before upgrading, we strongly recommend that you use the Backup function to back up all data to avoid data loss.
Step 3. Upgrade the Controller.
Enter the extracted folder.
cd Omada_Controller_v5.x.y.z_Linux_x64
Use the installation command to upgrade the Controller.
sudo ./install.sh
Enter y to confirm the installation. An upgrade confirmation prompt will appear. Enter Yes or y to confirm and continue the upgrade.
If the Controller is still running before the installation, the installation program will automatically stop the Controller. If the stop fails, please manually stop the Controller using the sudo tpeap stop command.
After the Controller is stopped, the upgrade will begin. After the upgrade is complete, the Controller will restart.
Choose a method below to confirm the upgrade.
- Method 1: Version Confirmation
Click the 
icon in the top right corner of the Controller.
Click About to view the current version information of the Controller. If it matches the version you upgraded, the upgrade is successful.
- Method 2: Upgrade Detection
Go to Settings > System Settings in the Global view (non-MSP mode) or MSP view (MSP mode), then click Check for Updates in the Controller Status section.
If the result shows that your Controller is up to date, the upgrade is successful.
You have now successfully upgraded your Omada Controller.
Get to know more details of each function and configuration please go to Download Center to download the manual of your product.
Why can't I detect the latest version on my Controller (with an internet connection) when the official website has released a new version?
Re: If your Controller is connected to the internet but cannot detect the latest version, it might be because the update has just been released and hasn't been pushed yet. For urgent use, you can download and upgrade manually.
