Home How to install Omada Software Controller V5 on Ubuntu 22.04

How to install Omada Software Controller V5 on Ubuntu 22.04


Omada Software Controller allows for centralised control over your TP-Link Omada network setup. The Software Controller is free to use, allowing users to manage up to 5000 devices. This guide will teach how to install the controller on an Ubuntu 22.04 server.


Before beginning the installation of the controller, there are dependencies that have to be installed in order for the controller to work. These Include:

  • MongoDB 4.4 which can be installed using this guide. As there is no install candidacy for Ubuntu 22.04.
  • JSVC
  • Java 11

Make sure Mongodb 4.4 is installed before continuing.

Begin by installing Java 11 for Omada SDN:

Update package manager:

sudo apt-get update

Install Java 11:

sudo apt-get install openjdk-11-jre-headless -y

Now create a directory that Omada requires:

sudo mkdir /usr/lib/jvm/java-11-openjdk-amd64/lib/amd64

Link the default directory to the new directory:

sudo ln -s /usr/lib/jvm/java-11-openjdk-amd64/lib/server /usr/lib/jvm/java-11-openjdk-amd64/lib/amd64/

Now install JSVC:

sudo apt-get install jsvc -y 


Visit the TP-Link Website for the newest installation of the Software Controller. However, currently due to changes on their website if you attempt to copy the link to download it will not work. So, I suggest following the guide and then updating the software controller when the Omada has successfully setup.

However, if you do want to download the latest version it will require extra steps than before.

  • Scroll down on the Website till you find the Linux .deb then right click on the download button and copy the link.
  • Now the link will look like this:
  • You will need to remove all the information after the .deb as this will cause the file to downloaded to be wrong as Ubuntu doesn’t understand the additional information.
  • The link should now look like this now:

Ignore above if you are following this guide more recently because you will be on the latest version of Omada and doesn’t apply, you can copy the command below.

After coping the link we will now use the wget command to download the file to our system.

sudo wget https://static.tp-link.com/upload/software/2023/202303/20230321/Omada_SDN_Controller_v5.9.31_Linux_x64.deb

After the installation of the .deb file you will need to begin installation of the application.

sudo dpkg -i Omada_SDN_Controller_v5.9.31_Linux_x64.deb

The name of the file may differ depending on the version downloaded.

After entering the previous command when everything has successfully installed you will be met with:

Install Omada Controller succeeded!
Omada Controller will start up with system boot. You can also control it by [/usr/bin/tpeap].
Starting Omada Controller. Please wait.............................
Started successfully.
You can visit http://localhost:8088 on this host to manage the wireless network.

Now go to http://server-ip:8088 to begin setup of the Omada Controller.


With a successful installation of the Omada Controller, you will now be able to control your Omada Devices in a centralised environment for quick management within your Local Network on Ubuntu 22.04.

This post is licensed under CC BY 4.0 by the author.

How to install MongoDB 4.4 on 22.04