Update - 22 November 2025

Version 6 is out and has been tested to work with Raspberry Pi 5 with the instructions in this guide.

This is a bare metal install on 64 bit Raspberry Pi OS - no Ubuntu server, no Docker.  Tested with version 6.0.0.24 of the Controller software. I have it running on a 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/202510/20251031/omada_v6.0.0.24_linux_x64_20251027202535.deb
   sudo dpkg -i omada_v6.0.0.24_linux_x64_20251027202535.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