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
- Copy Link
- Report Inappropriate Content
Glad to see that you got it working. Unless you specifically need the features / bug fixes from the latest version, just stay with the one you got working for now. The 3B will only work adequately for very small wifi systems with a few APs. TP-Link recommends a Intel Core i3-8100 with 16GB RAM or better to run the Controller, so keep that in mind when you are frustrated by the slow response on a Pi3B with 1GB of memory
- Copy Link
- Report Inappropriate Content
Fair enough. It eventually stopped working while I was poking around with the two AP's.
I tried the docker method but dang if there is not much "how to" on that.
I then bailed on the pi completely and tried to use my Odroid N2+ which should have enough power to be sufficent but I didn't have much luck with that either, broken dependinces etc. relating to MongoDB.
Any suggestion on a guide for Ubuntu 22.04 ?
I probably just need to hook up a monitor and use the desktop docker/portainer, I lack skills to do most anything in command line.
Thanks for the help, I think a little better pi and I'd be in business.
- Copy Link
- Report Inappropriate Content
You are correct, I don't think the 1G of RAM in the 3B will cut it with the latest controllers. You will also need a CPU heatsink to get past the initial install/setup. The initial setup of the container could take 10-20min before it stabilizes into its running config...so be patient!
You can see from my thread below, I used a US$30 2G Pi clone and docker, and it's been running since then at one of my sites just fine (and it's also running portainer and pihole and wireguard too). Have a look at post#14 https://community.tp-link.com/en/business/forum/topic/606692?sortDir=ASC&page=2. I have also upgraded the controller twice since that initial install...very easy...take backup, stop/delete old controller container, pull/build new container, restore backup.
- Copy Link
- Report Inappropriate Content
The Odroid n2+ is running perfectly, it's a shame I couldn't get the two pi's running because outside of a Octopi I have never used them for anything meaningful...
I am looking at adding the pi-hole stuff to the odroid as well.
More to learn, I will check out your thread, thanks.
- Copy Link
- Report Inappropriate Content
@CarterKraft I am curious what OS you got to work on the Odroid n2+ with Omada Controller, as you mentioned in an earlier post that you could not get it to work?
- Copy Link
- Report Inappropriate Content
First time attempting an upgrade - going from 5.12.7 to 5.13.30.8
The new deb package will be in my home directory
To upgrade do we simply:
sudo apt install new package name DOT deb
or
sudo dpkg --install new package name DOT deb
Will all my settings carry over? (Yes I will backup just in case).
Thank you
- Copy Link
- Report Inappropriate Content
when I upgrade I first take backup of controller then I use this command from ssh console.
sudo -s
cd /tmp
wget https://static.tp-link.com/upload/software/2023/202312/20231201/Omada_SDN_Controller_v5.13.22_Linux_x64.deb
dpkg -i Omada_SDN_Controller_v5.13.22_Linux_x64.deb
- Copy Link
- Report Inappropriate Content
Ubuntu 22.04 mate from the Odroid wiki page.
I never tried the desktop environment though so I could have used the lite version I suppose.
- Copy Link
- Report Inappropriate Content
@VE7KOD The are obviously a number of ways (see other posts).
When I upgrade I uninstall
<sudo apt remove omadac>
The uninstaller will ask if I want to save settings, which I want and select yes.
Then I install the new version with the command in the guide (sudo apt install ,,...)
During the new install the installer will find the saved settings and ask if you want to import, and then you select yes
- Copy Link
- Report Inappropriate Content
Information
Helpful: 12
Views: 116925
Replies: 143
Voters 3
