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 for the info
- Copy Link
- Report Inappropriate Content
@kilovar I followed the steps and it saves the file but then i cant ever get it to run. Im very new at this so im sure im missing something simple. I hope you can help.
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
Where can I find the link for the current Omada controller software?
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
I just did a fresh install of the new Raspberry Pi OS "Trixie" release & libssl1.1 is no longer in the repos so I am getting a mongoDB dependency error. Also there is no more openjdk-17-jre-headless
dpkg: dependency problems prevent configuration of mongodb-org-server:
mongodb-org-server depends on libssl1.1 (>= 1.1.0); however:
Package libssl1.1 is not installed.
dpkg: error processing package mongodb-org-server (--install):
dependency problems - leaving unconfigured
Processing triggers for man-db (2.13.1-1) ...
Errors were encountered while processing:
mongodb-org-server
You might want to run 'apt --fix-broken install' to correct these.
Unsatisfied dependencies:
mongodb-org-server : Depends: libssl1.1 (>= 1.1.0) but it is not installable
Error: Unmet dependencies. Try 'apt --fix-broken install' with no packages (or specify a solution).
~ $ sudo apt-get install libssl1.1
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Package libssl1.1 is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source
E: Package 'libssl1.1' has no installation candidate
sudo apt-get install openjdk-17-jre-headless
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Package openjdk-17-jre-headless is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source
However the following packages replace it:
openjdk-21-jre:armhf openjdk-21-jdk-headless:armhf openjdk-21-jre openjdk-21-jdk-headless
- Copy Link
- Report Inappropriate Content
@Tazed1 I see that there was an update on Oct 1, that updated the Debian base to V13 (Trixie) and with that the repos would have been updated. Both my OmadaSDN PIs are still running RaspiOS based on V12 Bookworm, so the older repos still work.
You can try installing whatever version of libssl is available in the repo, and the same with openjdk-XX-jre-headless and see if it runs. Alternatively you can still download and install Raspberry Pi OS (Legacy) Lite and hopefully the older repos would still work. Note that the above are just ideas and have not been tested.
I will do my own fresh install of RaspiOS (Trixie) and see if I can get it to work, when I have time this weekend.
- Copy Link
- Report Inappropriate Content
There is no other version of libssl in the Trixie repo. No other candidate to install. There is no way to proceed at this point. Only to install it as a Docker unfortunately.
- Copy Link
- Report Inappropriate Content
@Tazed1 No need to bail for docker yet. All you need to do is install libbsl1.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
Then mongodb will install as per instructions
For openjdk you install version 21
sudo apt install openjdk-21-jdk-headless
and the rest will work as per instructions. Tested and confirmed on Raspberry Pi 4B
- Copy Link
- Report Inappropriate Content
Information
Helpful: 12
Views: 114455
Replies: 142
Voters 3
