Installing TP-Link Omada Controller on Ubuntu

I have a bunch of TP-Link EAP model WiFi access points in my home, these are enterprise grade devices allow management via a unified controller, TP-Link call their controller software Omada.

This is very similar to Ubiquiti’s Unifi controller. Whilst I don’t have any other Unifi equipment, I found the TP-Link access points to be cheaper and perform just as well.

The WiFi access point models I user are the EAP225. These are dual band (2.4 and 5Hgz) with PoE, currently about £65 on Amazon UK.

Getting started

This tutorial will install the Omada controller on Ubuntu. In my case, this was Ubuntu 18.04, and the Omada Controller version v3.2.10.

I’m running this in an Ubuntu LXD container, but I imagine this would work fine on a bare-metal install.


    1. Update your packages:
      sudo apt-get update
    2. Install Mongo DB:
      sudo apt-get install mongodb
    3. Install JSVC, a tool to launch Java applications as daemons:
      sudo apt-get install jsvc
    4. Install Open JDK v8:
      sudo apt-get install openjdk-8-jdk
    5. Configure system to use ‘… 8-openjdk …’, usually this is option 2:
      sudo update-alternatives --config java
    6. Now, we have installed the prerequisites, you now need to download the Omada controller package.In this tutorial the ‘.deb’ packages will be installed, these offer the most easiest way to install the Omada controller software.

      Download the latest Omada controller software from TP-Link’s website here:

      In this example, I am using version 3.2.10.Download the package via WGET:

      sudo wget

    7. Install the package:
      sudo dpkg –i omada_v3.2.10_linux_x64_20200330135119.deb
    8. The installation will then guide you through the rest of the installation. Once complete, you will be prompted to go to a web address to finish setup. E.g. http://LOCALHOST/YOUR IP ADDRESS:8088.
    9. You can start/stop the controller software with these commands:Start the controller. By default your controller should run at start-up, but try this for a manual start:
      sudo tpeap start

      Stop the controller:

      sudo tpeap stop

      See the status the running controller:

      sudo tpeap status

Final Notes

This tutorial can be installed on any Ubuntu running computer; Container (as I do) or Bare-Metal device. If you don’t have the ability to run this software on your own hardware, TP-Link have their own device to run the controller software; the Omada Cloud Controller OC200, which is around £65 on Amazon UK.

If you found this tutorial helpful, or wish to buy these products, consider using my affiliate links:


Monkey Archie
  • March 31st, 2021

Thanks for this guide – very quick and easy to follow!

  • June 29th, 2021

Thanks for your guide. I used it to install the Omada Controller software on a Raspberry Pi. I wanted to have a dedicated controller, but didn’t want to spend the money on TP-Links. You can follow the same steps in your guide using a Raspberry Pi 4 and installing the Ubuntu 20.04 64bit server they have built for the Raspberry Pi 4 and it works great and you essentially have a dedicated hardware controller.

  • June 30th, 2021

Hi Gary, glad this guide has been of help you. Thanks for the extra notes regarding Ubuntu 20.04 too!

Post a Comment