Guide to Installing Omada Software Controller on Raspberry Pi OS - V6
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
- Copy Link
- Subscribe
- Bookmark
- Report Inappropriate Content
heh, well, whatever works. I'm actually toying with the idea of doing a setup from scratch on the raspberry pi and seeing how it behaves. Can't migrate but perhaps moving forward I'd be ok. Of course, that's just a LOT of work to reset switches and AP and then rebind them with the new controller, set up all the reservations and NAT forwarding and all of that.
perhaps I'll just use my RPi 4 ;)
carry on and good luck!
- Copy Link
- Report Inappropriate Content
@kilovar Just a heads up with the new version of the Omada Software Controller, I was able to use that at the end versus 5.12. See command below:
sudo dpkg --ignore-depends=jsvc -i omada_v5.13.23_linux_x64_20231228194020_1705040408024.deb
This all worked great to install on my new Raspberry pi 5 I had setup. I initially tried docker which I thought was not working, albeit that I think was because I was trying to go to port 8043 directly which was not right. I had to go to 8088. Anyway, uninstalled the docker version, used these instructions, and was in business!
- Copy Link
- Report Inappropriate Content
@kilovar Salut j'ai d'installer cette version sur mint cinnamon ou sur Raspberry pi 3B+ Os raspbian et je me retrouve toujours bloquer soit par ce que les parquet son corronpue ou je n'est pas les droit superutilsateur et meme avec ca ne fonction il met impossible de l'installer.
pouvez vous m'aide
- Copy Link
- Report Inappropriate Content
@Philneo This guide is for Raspberry Pi OS specifically. Working knowledge of Debian based install procedures is a requirement. The ability to get superuser (or sudo) access is another requirement, and is outside the scope of this guide. The guide has been tested and works on Raspberry Pi3B+. It sounds like the missing part is basic debian linux knowledge.
Philneo wrote
@kilovar Salut j'ai d'installer cette version sur mint cinnamon ou sur Raspberry pi 3B+ Os raspbian et je me retrouve toujours bloquer soit par ce que les parquet son corronpue ou je n'est pas les droit superutilsateur et meme avec ca ne fonction il met impossible de l'installer.
pouvez vous m'aide
- Copy Link
- Report Inappropriate Content
has anyone managed to bind their rPi controller to their TP Link account? When I try I get a "general error"
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
Thanks.. Thinking it's something to do with my DNS server also being on the localhost I'm running the controller on, or a port forwarding issue thru the firewall (all Omada/Jetstream). I can click 'check for updates' for the controller and it works, confirms I'm on the latest version, so I'm a bit stumped at the moment but still working on it.
Thanks for the replies..
Jesse
- Copy Link
- Report Inappropriate Content
Got it sorted..
Had to delete all the files under /opt/tplink/EAPController/data/db/
Then reinstalled the deb file and went through the CLI wizard again. Once that was done, I then had to re-do the webgui but skip all the set up stuff and head straight to the Cloud Access and bind the controller. Worked first time.
Then I had to re-adopt all my devices etc (if I was thinking I could have just exported the setup before deleting all those files... )
FYI for anyone in the future.
- Copy Link
- Report Inappropriate Content
So now I have a new question - I just migrated my omada controller to another pi I have running that is a bit more stable (my prior one keeps crashing and I think there is a hardware issue with my power cable and/or the connector on the pi).
The migration went perfectly, all set. But I can't seem to figure out how to uninstall the omada controller on my older pi. Anyone know how to do this with the newer versions? I was looking for an uninstall script, but can't find it.
Thanks in advance.
Sunil
- Copy Link
- Report Inappropriate Content
Information
Helpful: 15
Views: 140924
Replies: 146
Voters 4
