Update - 26 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/202510/20251031/omada_v6.0.0.24_linux_x64_20251027202535.deb
sudo dpkg -i omada_v6.0.0.24_linux_x64_20251027202535.deb

Links have been updated and verified on most recent install

Instructions: (Works on both Pi 4B and Pi5)

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.

Alternate Instructions to install MongoDB V8.0 on Pi 5 only - it will not work on Pi4

2. Tell your system to trust mongodb.org

    wget -qO - https://www.mongodb.org/static/pgp/server-8.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-8.0.gpg

3. Tell apt where to find the MongoDB V8.0 repository

    echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

4. Install MongoDB Server v8.0

    sudo apt update

    sudo apt install mongodb-org-server

Combined Instructions for remainder of the process

5. Check that curl is installed

   apt list curl

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

7. Install jsvc
   sudo apt install jsvc
   
8. 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.

9. 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