Blog

How to install TP-Link Omada controller on Debian

Learn how to install the TP-Link Omada controller on Debian

TP-Link Omada logo and Debian logo

Alex Lowe

June 24, 2025

To install the TP-Link Omada on Debian, follow the steps below.

If you want fast and reliable Omada hosting, check out HostiFi with fast support, regular backups, managed updates and prices from just $9 per month.

To learn more about our hosting plans, create an account and get started today.

The TP-Link Omada controller runs on both Linux and Windows and lets you manage your Omada wireless access points, gateways and switches.

Requirements

  • Java (OpenJDK 8 or 11)
  • 64-bit version of Debian (Omada doesn't support 32-bit)

Update the system

sudo apt update && sudo apt upgrade -y

Install the required dependencies

sudo apt install -y openjdk-11-jre-headless curl gnupg mongodb-org-server

Add TP-Link Omada repository

Replace the URL with the current version, which can be found on the TP-Link website.

wget https://static.tp-link.com/upload/software/2024/Omada_SDN_Controller_v5.12.7_Linux_x64.deb

Install the Omada Controller

Replace the file name with the one you have downloaded.

sudo dpkg -i Omada_SDN_Controller_v5.12.7_Linux_x64.deb

Start and enable the service

sudo systemctl start omada
sudo systemctl enable omada

Access the Web Interface

https://<your-server-ip>:8043

That's it! You should now have the TP-Link Omada Controller installed and running on your Debian instance!

HostiFi

HostiFi provides hosting for both Ubiquiti and TP-Link software-defined-networking (SDN) applications, with servers for UniFi, UISP and Omada. We also offer network consulting, with HostiFi Professional Services.

More Blog Posts

Get the Ubiquiti Top 20

Each month our team sifts through Ubiquiti news and content from around the web and delivers 20 of our favorite links to your inbox.

View recent issues

No spam. Unsubscribe anytime.

🤩

Discovered 3+ things that I did not know and will have a material impact on my business.

Newsletter Subscriber

🤩

All the info I want/need in a single clean thread! Perfect!

Newsletter Subscriber

🤩

Providing super valuable information to keep the community in the know. Awesome links page, Thank You.

Newsletter Subscriber