The process of installing the Omada Software Controller on a Raspberry Pi is reasonably straightforward, with a few quirks due to the platform not being officially supported by TP-Link Omada.
Requirements
- Raspberry Pi 4(or 5) with 4GB+ Memory
- Compatible TP-Link Omada Router(ER605)
SD Card Setup
Download the Ubuntu Server 24.04 image, and write it your MicroSD card.
For step-by-step instructions for setting up the MicroSD card with Ubuntu Server, refer to the official Raspberry Pi documentation.
Image Writing Tools
Raspberry Pi Imager – This is my preferred tool for setting up a Raspberry Pi OS image.
The Raspberry Pi Imager tool lets you pre-configure the Hostname, Login Credentials, SSH Keys, and additional options unavailable using other image writing tools.
Balena Etcher – Popular cross-platform tool for writing images to USB/SD Cards.
USB Imager – Lightweight Open Source image writing tool; works with standard user-level accounts in Windows.
Raspberry Pi Setup
Once you have configured your MicroSD card with the Ubuntu Server image, login to the Raspberry Pi via SSH, or the local console.
Note: If you didn’t use the Raspberry PI Imager to pre-configure your login details, you’ll have to set a new password after the first login(Default login is ubuntu/ubuntu), and configure the WIFI credentials.
Once the WIFI connection is established, we’re ready to begin installing the Omada requirements.
Before we begin, double-check that any upgrades are complete before starting apt.
Update existing packages:
sudo apt-get update
sudo apt-get -yV upgrade Install Utilities
sudo apt install nano wget screen curlInstall Java
sudo apt install openjdk-17-jre-headless
sudo apt install jvscFix Java Home error:
ln -s /usr/lib/jvm/java-17-openjdk-arm64 /usr/lib/jvm/default-javaInstall MongoDB 4.x
MongoDB changed their architecture in 4.19 release, making further versions incompatible with the Raspberry Pi.
To avoid compatibility issues, we’ll be installing the older release of MongoDB 4.18 manually:
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.debYou may get an error that Package libssl1.1 is not installed:
mongodb-org-server depends on libssl1.1 (>= 1.1.0); however:
Package libssl1.1 is not installed.If this happens, install the missing package manually, and then repeat the install for MongoDB:
wget http://launchpadlibrarian.net/741613665/libssl1.1_1.1.1f-1ubuntu2.23_arm64.deb
sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.23_arm64.deb
sudo dpkg -i mongodb-org-server_4.4.18_arm64.debInstall Omada Network Controller
Now that OpenJDK & MongoDB are installed, we’re ready to Install the Omada Network Controller.
Download the latest Omada x64.deb package from the Omada software center.
wget -q -O omada.deb https://static.tp-link.com/upload/software/2025/202510/20251031/omada_v6.0.0.24_linux_x64_20251027202535.debAs of November 2025, the latest version is v6.0.0.24
sudo dpkg -i omada*.debIt may take a few moments to complete the installation. The network controller will start up automatically as part of the install process.
Installation Example
root@omadapi:~# sudo dpkg -i omada*.deb
Selecting previously unselected package omadac.
(Reading database ... 59655 files and directories currently installed.)
Preparing to unpack omada_v5.15.24.18_linux_x64_20250630184434.deb ...
JRE 17.0.15 is greater than 8 and JSVC 1.0.15 is less than 1.1.0
Unpacking omadac (5.15.24.18) ...
Setting up omadac (5.15.24.18) ...
Install Omada Controller succeeded!
==========================
current data is empty
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.Once the installation is complete, you’ll be able to access the Omada Network Controller in your browser
https://ip.add.re.ss:8043
http://ip.add.re.ss:8088
You should now be staring at the Omada Setup screen.
Updating Omada Software Controller
Omada will often alert you to new release versions from the Omada Controller dashboard, however, there’s no built-in-update mechanism.
To update the Omada controller software to the latest version, download the latest package from the Omada Controller repository.
wget -q -O omada.deb https://static.tp-link.com/upload/software/2025/202510/20251031/omada_v6.0.0.24_linux_x64_20251027202535.debBackup Prior to Upgrading
Before beginning the upgrade, it is strongly advised to back up your current Omada Software Controller configuration.
To create a new configuration backup, go to: Omada > Global View > Settings > Maintenance.
To create the backup, click the Export button under the Backup heading.
After the backup process is complete and the backup is successfully generated, you will receive a prompt asking you to download the backup.cfg file directly to your local computer or device.
In case you ever need to perform a factory reset or encounter any issues that require restoring your system, you can use this .cfg file to fully restore your entire Omada Controller configuration quickly and efficiently.
Note: Omada supports automatic backups. For detailed information about the Backup and Restore system, please consult the Omada Documentation.
Omada Software Controller Upgrade
Once a config backup was generated, you can install the updated .deb package, and overwrite the existing Omada Controller installation.
sudo dpkg -i omada*.debHere’s the output of a successful upgrade from Omada 5.15 to 6.0.0:
omadapi:~$ sudo dpkg -i omada*.deb
(Reading database ... 60673 files and directories currently installed.)
Preparing to unpack omada_v6.0.0.24_linux_x64_20251027202535.deb ...
Omada Controller is running, going to stop it.
Stopping Omada Controller
Stop successfully.
A previous controller version has been detected.
Unpacking omadac (6.0.0.24) over (5.15.24.18) ...
Setting up omadac (6.0.0.24) ...
Install Omada Controller succeeded!
==========================
data dir is not empty.
current data is not empty
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.