Guide to Installing Omada Software Controller on Raspberry Pi OS - V5

Guide to Installing Omada Software Controller on Raspberry Pi OS - V5

Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-01-30 18:35:03 - last edited 8 hours ago
Hardware Version:
Firmware Version: 5.15.24

Update - 4 October 2025

The latest Raspberry Pi OS (Debian Base Pixie) broke some of the install repo's and the install instructions have been updated and tested to work wih a fresh install of the current Raspberry Pi OS as of this date.  

 

The Raspberry Pi OS (Legacy) based on Debian Bookworm was tested and does not work out of box either, so does not offer any benefit - the installation instructions is now based on the default Raspberry Pi OS version available at this date.

 

This is a bare metal install on 64 bit Raspberry Pi OS - no Ubuntu server, no Docker.  Tested with version 5.15.24 of the Controller software. I have it running on a Model 4B and Model 5 Pi.   The recent versions of the Omanada SDN Controller does not run on the Model 3B, 3B+

 

To update the Controller version on a working Raspberry Pi without updating Raspberry Pi OS, do the following

 

sudo tpeap stop

sudo apt remove omadac       

During the uninstall process select the option to save the current settings.  This allows the existing settings to be applied automatically to the updated version

wget https://static.tp-link.com/upload/software/2025/202508/20250802/omada_v5.15.24.19_linux_x64_20250724152622.deb
sudo dpkg -i omada_v5.15.24.19_linux_x64_20250724152622.deb

 

 

Links have been updated and verified on most recent install

 

Instructions:

 

1. Download & install latest 64 bit LITE version of Raspberry pi OS to new sd card of your choice from the link below. Note - the legacy version of Raspberry Pi OS will not work
    https://downloads.raspberrypi.org/raspios_lite_arm64/images/
    This is not a guide to installing Raspberry Pi OS so I won't provide detailed instructions on that.

 

2. Download and install libssl1.1 manually

     wget http://security.debian.org/debian-security/pool/updates/main/o/openssl/libssl1.1_1.1.1w-0+deb11u4_arm64.deb

     sudo dpkg -i libssl1.1_1.1.1w-0+deb11u4_arm64.deb

 

3. Download and install version 4.4.18 of MongoDB mongodb-server from https://www.mongodb.com/download-center/community/releases/archive
   wget https://repo.mongodb.org/apt/ubuntu/dists/focal/mongodb-org/4.4/multiverse/binary-arm64/mongodb-org-server_4.4.18_arm64.deb
   sudo dpkg -i mongodb-org-server_4.4.18_arm64.deb

 

   Note this post explaining that MongoDB V4.4.19 will not work.

 

3. Check that curl is installed

   apt list curl

 

5. Download and install openjdk-21
    sudo apt install openjdk-21-jdk-headless

 

6. Install jsvc
   sudo apt install jsvc
   
7. If you have multiple versions of OpenJDK installed then you need to tell system which java to use
   sudo update-alternatives --config java

 

  Selection    Path                                            Priority   Status
------------------------------------------------------------
  0            /usr/lib/jvm/java-11-openjdk-arm64/bin/java      1111      auto mode
  1            /usr/lib/jvm/java-11-openjdk-arm64/bin/java      1111      manual mode
* 2            /usr/lib/jvm/java-8-openjdk-arm64/jre/bin/java   1081      manual mode

Press <enter> to keep the current choice[*], or type selection number:

 

   Now select the option pointing to the version of OpenJDK you want to use.

 

8. Download and install latest version Omada SDN controller
   wget https://static.tp-link.com/upload/software/2025/202508/20250802/omada_v5.15.24.19_linux_x64_20250724152622.deb
   sudo dpkg -i omada_v5.15.24.19_linux_x64_20250724152622.deb

 

 

If all went well the controller should start and you should get the following message

 

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

 

Now you can access the web interface of the Omada Controller by pointing you web browser from any PC on the same network to 

http://<IP_address_of_Omada_Controller>:8088

  12      
  12      
#1
Options
1 Accepted Solution
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5-Solution
2022-04-26 05:59:28 - last edited 2022-04-30 20:06:38

  @kilovar 

For the newer versions I was getting the error:
 

 omadac : Depends: mongodb-server (< 1:4.0.0) but it is not installable or
                   mongodb-10gen (< 4.0.0) but it is not installable or
                   mongodb-org-server (< 4.0.0) but 4.4.13 is installed
 

 

It worked using instead:
dpkg -i --ignore-depends=jsvc,mongodb-server Omada_SDN_Controller_v5.1.7_Linux_x64.deb
Recommended Solution
  8  
  8  
#3
Options
142 Reply
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS (For Controller v5)
2022-02-08 08:28:54

Dear @kilovar

 

Thank you for your sharing on the community!

 

This guide is applied to Omada Controller v5, I'd suggest you add it in the subject title of this post. Cheers!

>> Omada EAP Firmware Trial Available Here << *Try filtering posts on each forum by Label of [Early Access]*
  1  
  1  
#2
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5-Solution
2022-04-26 05:59:28 - last edited 2022-04-30 20:06:38

  @kilovar 

For the newer versions I was getting the error:
 

 omadac : Depends: mongodb-server (< 1:4.0.0) but it is not installable or
                   mongodb-10gen (< 4.0.0) but it is not installable or
                   mongodb-org-server (< 4.0.0) but 4.4.13 is installed
 

 

It worked using instead:
dpkg -i --ignore-depends=jsvc,mongodb-server Omada_SDN_Controller_v5.1.7_Linux_x64.deb
Recommended Solution
  8  
  8  
#3
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-05-03 00:20:13

  @kilovar The java 8 package doesn't seem to be available anymore. I have found the same version for ubuntu, but I am too much of a noob to know if it is the same thing or if it will not work on this version of linux or not.

 

Do you have an updated link?

 

I will experiment and see what happens. I was hoping to not have to go back and forth on this too much though.

 

Thank you for the guide though!

  0  
  0  
#4
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-05-03 01:13:40

  @VinGGR 

 

Can you please tell me how to apply this. I am a linux noob and still learning. 

  0  
  0  
#5
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-05-03 02:07:51

Dbert wrote

  @kilovar The java 8 package doesn't seem to be available anymore. I have found the same version for ubuntu, but I am too much of a noob to know if it is the same thing or if it will not work on this version of linux or not.

 

Do you have an updated link?

 

I will experiment and see what happens. I was hoping to not have to go back and forth on this too much though.

 

Thank you for the guide though!

 @Dbert It is still available at the same location, but the name of the file changed to a newer version - openjdk-8-jre-headless_8u322-b06-1~deb9u1_arm64

 

Unfortunately there are new rules on this site that does not allow me to post links anymore, so follow the link to the directory holding the files posted previously and there you will find the fill name I posted above

  0  
  0  
#6
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-06-23 14:16:20

  @kilovar I'm running Omana Software Controller on a RPi 3B (1GB RAM) for years now. And Version4 was running really well.

But since the upgrade to Omada Version 5, which needed a clean install, my RPi runs out of RAM very fast and then isn't responsive at all, no SSH, nothing... (no screen connected, so I don't know what would be there).

 

What RPi do you use to run Omana Software Controller 5?

 

Do you know any configs to size the down the controllers resources? I used htop to inspect the process and it eats up all the RAM. 

 

I just run a very small network with 2 EAPs and a Portal for guest to login

  0  
  0  
#7
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-06-23 15:27:36
@Khaos I was able to get V5 to install on RPi 3B but I've never tried running it as a production system. Just watching the memory usage was enough indication to know that it would not work. I currently run Omada SDN V5 on a RPi 4B w/ 4GB RAM and it runs flawless with 4 EAPs and Omada router. Looking at the total memory use it seems to max out around 2GB, so I think you'll be able to run it fine on a 2GB RPi 4B. But since the RPi3B is only available in 1GB version I just dont see it working
  0  
  0  
#8
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-06-23 17:05:09

  @kilovar I see. Thank you for the fast answer

  0  
  0  
#9
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-07-01 18:49:57

@Khaos I fear that you are getting a bit of inaccurate information.  A raspberry pi 3B should have no issue running an install of Omada .... especially on a Raspberry Pi OS Lite install.  I suspect what has happened with your install is that you have not enabled RAM compression or a swap file/partition.  I currently run Omada v5 on a Raspberry Pi 3B with an Ubuntu server install and it runs flawlessly, has been for a few months straight (aside from the reboots needed due to some software updates).  It will need to be able to swap out pages on occassion but this is certainly no reason to go run down a new Pi4, especially in today's market.  Swap partitions/files are tried and true methods of dealing with infrequent paging needs.  Add something like RAM compression and lessen the need for paging even more. As you can see, there is PLENTY of CPU cycles available to handle a little memory compression.  I suspect that, compared to Ubuntu Server, there is even less overhead in a Raspberry Pi OS Lite install, though I haven't tested that personally.  Give it a try, might save you the sticker shock of a Pi4 and the frustration of locating one, you certainly have nothing to lose.

 

  1  
  1  
#10
Options
Re:Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
2022-07-01 19:06:52

  @jomiller48 that sounds wonderful!

I also use Ubuntu server. I'll try to find a tutorial for that matter and have a try :)

  0  
  0  
#11
Options