Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
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
- Copy Link
- Subscribe
- Bookmark
- Report Inappropriate Content
Thank you.. I did search through the 9 pages but nothing jumped out at me - my appoligies and appreciate the reply..
and succesfully updated to 5.13.30.8 and running smoothly so far!
Sugestion - add that info to the first page for new comers so it's easier to find..
Where do I send beer/coffee money!?!
Jesse
- Copy Link
- Report Inappropriate Content
Hi,
I have tried installing it on a RPI3 B+. I have followed the steps but in the end, no matter what I do I always get the " Please wait.Cannot find any VM in Java Home /usr/lib/jvm/java-11-openjdk-arm64/". I tried many solutions, none worked, At this point I am not sure what I am doing wrong. I have tried with Java 11, and java 17 with the same results.
I have created the symbolic links:
# mkdir /usr/lib/jvm/java-11-openjdk-amd64/lib/amd64
# ln -s /usr/lib/jvm/java-11-openjdk-amd64/lib/server /usr/lib/jvm/java-11-openjdk-amd64/lib/amd64/
The results are the same.
Does anyone else experienced this, where should I look next?
Thanks!
- Copy Link
- Report Inappropriate Content
Couple of point to consider
1. RPi3+ really does not work well for anything other than novelty - just not enough memory
2. Please run the following command and post your output
sudo update-alternatives --config java
3. The paths you posted about creating symlinks indicating AMD64 binaries, so I dont know what you are trying to do there
- Copy Link
- Report Inappropriate Content
Thanks!
to answer quickly:
1. I am not using it really, just want to install it an play with it, this is for a future project and I am getting aquainted with the system. I have no EAP for now.
2. This is the output of the update-alternatives:
octavg@OmConPi3:~ $ sudo update-alternatives --config java There are 2 choices for the alternative java (providing /usr/bin/java). Selection Path Priority Status ------------------------------------------------------------ 0 /usr/lib/jvm/java-17-openjdk-arm64/bin/java 1711 auto mode * 1 /usr/lib/jvm/java-11-openjdk-arm64/bin/java 1111 manual mode 2 /usr/lib/jvm/java-17-openjdk-arm64/bin/java 1711 manual mode Press <enter> to keep the current choice[*], or type selection number:
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
I'm with kilovar above, 1G RAM is just not enough for 5.13 controllers. Try installing a 5.8 or older controller.
I run mine in containers, but to put things in perspective, you need at least 1.2G and the below examples are small sites :
x86 based NAS, v5.13
S905 Pi Clone 2G 4core, v5.13
- Copy Link
- Report Inappropriate Content
Run the follow command
ls -l /usr/bin/java
Expected output
/usr/bin/java -> /etc/alternatives/java
If your output matches the expected output above run the following
ls -l /etc/alternatives/java
Expected output
/etc/alternatives/java -> /usr/lib/jvm/java-11-openjdk-arm64/bin/java
If your output from the second command is not as expected please post it for review
- Copy Link
- Report Inappropriate Content
Hi Kilovar,
The output is as expected:
octavg@OmConPi3:~ $ ls -l /usr/bin/java lrwxrwxrwx 1 root root 22 Mar 21 09:40 /usr/bin/java -> /etc/alternatives/java octavg@OmConPi3:~ $ ls -l /etc/alternatives/java lrwxrwxrwx 1 root root 43 Mar 21 09:44 /etc/alternatives/java -> /usr/lib/jvm/java-11-openjdk-arm64/bin/java octavg@OmConPi3:~ $
- Copy Link
- Report Inappropriate Content
Did you start with a clean install of raspberry pi OS Lite?
I retested the install procedure on a fresh install on a RPi 3A+ and had no problem following the steps described in the first post
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
Information
Helpful: 12
Views: 115839
Replies: 143
Voters 3
