Guide to Installing Omada Software Controller on Raspberry Pi OS - V5
![](/avatar/default.png)
Update - 16 January 2024
Instructions below updated to most current Raspberry Pi OS, installed and tested on Raspberry Pi 5, with Omada SDN Controller v5.12.7. Confirmed that OpenJDK-17 work, which is installable through apt and for which the install instructions have been updated.
Update - 26 December 2023
Instructions below updated to most current Raspberry Pi OS, installed and tested on Raspberry Pi 5, with Omada SDN Controller v5.12.7. Note that the JAVA runtime installation instructions has been updated to OpenJDK-11.
Update - 3 June 2023
The links listed below for OpenJDK-8 no longer works. Omada SDN Controller will run on OpenJDK-11, but that requires JSVC 1.1.0 which is not in the official Raspberry Pi OS repos. It is possible to solve the dependecies to install JSVC 1.1.0, but I have not had time to update the instructions
Also see this FAQ with good info about installing the Omada SDN Controller on a number of Linux distros.
Update - 22 January 2023
Bare metal install on 64 bit Raspberry Pi OS - no Ubuntu server, no Docker. Tested with version 4 and now the latest version 5.7.4 of the Controller software. I have it running on a Model 3B+ with 1G RAM. Also running on Model 4 w/ 4G RAM.
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 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 apt install /home/<username>/mongodb-org-server_4.4.18_arm64.deb
Note this post explaining that MongoDB V4.4.19 will not work.
3. Mongodb server would normally be run as a service by doing the following commands
sudo systemctl daemon-reload
sudo systemctl enable mongod
sudo systemctl start mongod
In this case not required, as Omada controller starts the server as required.
4. Check that curl is installed
apt list curl
5. Download and install openjdk-17-jre
sudo apt install openjdk-17-jre-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/2023/202309/20230920/Omada_SDN_Controller_v5.12.7_Linux_x64.deb
sudo apt install /home/<username>/Omada_SDN_Controller_v5.12.7_Linux_x64.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
- Copy Link
- Report Inappropriate Content
Post #14 in the link which is the title of this post. Forum won't let me paste it into body via Android phone sorry!
- Copy Link
- Report Inappropriate Content
@kilovar What Java file should we be downloading now? I do not believe the updated file is currently available?
Could we download one from this location (Sorry, I did my best to post the link)?
http://
ftp.
debian.
org
debian/
pool/
main/o/openjdk-8/
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
Have been running Omada on my 4Gig Pi 4B for over a year and never had it crash. It's also running PiVPN and Pi-Hole for DNS /w Lighttpd as the web back end. My swap is 100M and the Pi never writes to it.
- Copy Link
- Report Inappropriate Content
There were a number of recent posts about the links to openjdk-8 not working - it looks like the good folks over at Debian stopped supporting and updating openjdk-8 and removed all links to it.
Technically the Omada Software Controller will run on OpenJDK-11, but then you require JSVC 1.1.0 which is not in the official raspberry pi repos. It is possible to solve the dependency and run on OpenJDK-11 and JSVC 1.1.0 but the last time I did it was a bit convoluted
Also refer to this FAQ that provides information on installing Omada Software Controller on a range of distros.
https://www.tp-link.com/ca/support/faq/3272/
Unfortunately we cannot control the decisions made by the good folks over at Debian or the Raspberry Pi foundation, but with Debian 12 to be released imminently and hopefully implemented on Raspberry Pi OS soon this current situation may improve.
To those who just want a formula to run Omada SDN controller on Rasperry Pi, there are many other ways to do it from Ubuntu, Docker, and many other. This thread is dedicated to overcoming the challenges with running Omada on the stock firmware.
- Copy Link
- Report Inappropriate Content
kilovar wrote
Update - 3 June 2023
The links listed below for OpenJDK-8 no longer works. Omada SDN Controller will run on OpenJDK-11, but that requires JSVC 1.1.0 which is not in the official Raspberry Pi OS repos. It is possible to solve the dependecies to install JSVC 1.1.0, but I have not had time to update the instructions
I guess I will wait for full instruction.
I have no clue where to get those repos.
EDIT: I attempted to install Omada Software Controller on Raspbbery Pi OS
> Starting Omada Controller. Please wait.Cannot find any VM in Java Home /usr/lib/jvm/java-11-openjdk-arm64/
It won't start properly. I tried following the guide on FAQ. What do I do from here?
EDIT: Found the problem. I had to uninstall the jsvc. Compile and make on the pi. The FAQ had a section addressing the problem. I also downgrade mongodb to 4.4.18 just in case.
- Copy Link
- Report Inappropriate Content
@kilovar any update to this??
- Copy Link
- Report Inappropriate Content
![](/avatar/default.png)
Information
Helpful: 8
Views: 69209
Replies: 116
Voters 3
![voter's avatar](https://static-community.tp-link.com/icon/57d94885dda247099ec65a4e7e1ec261.jpeg)
![voter's avatar](/avatar/avatar-20.png)
![voter's avatar](https://static-community.tp-link.com/icon/a8413ef3836c427db6c14636fc73059f.jpeg)