TP-Link’s Omada Software Controller is a powerful tool for centrally managing your TP-Link network devices. It provides a user-friendly web interface to configure and monitor access points, switches, and gateways. This comprehensive guide will walk you through the process of installing the Omada Software Controller on Ubuntu 20.04 and 22.04.


Before proceeding with the installation, ensure your system meets the following requirements:

  • Ubuntu 20.04 or 22.04 operating system
  • Minimum 2 GB RAM and 20 GB storage
  • Stable internet connection
  • Root or sudo access to the system

Step 1: Update the System

Start by updating your Ubuntu system to ensure you have the latest packages and security patches. Open a terminal and run the following commands:

sudo apt update
sudo apt upgrade -y

Step 2: Install Dependencies

The Omada Software Controller requires several dependencies to function properly. Install them by running the following command:

sudo apt install openjdk-11-jre-headless jsvc curl -y

This command installs OpenJDK 11 (Java Runtime Environment), JSVC (Java daemon), and curl.

Step 3: Install MongoDB

Omada Software Controller uses MongoDB as its database. Follow these steps to install MongoDB:

  1. Import the MongoDB GPG key:

    curl -fsSL | sudo apt-key add -

  2. Add the MongoDB repository to the system:

    echo "deb [ arch=amd64,arm64 ] $(lsb_release -cs)/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

  3. Update the package list and install MongoDB:

    sudo apt update
    sudo apt install mongodb-org -y

  4. Start the MongoDB service and enable it to start automatically on system boot:

    sudo systemctl start mongod
    sudo systemctl enable mongod

Step 4: Download and Install Omada Software Controller

  1. Visit the TP-Link website and download the latest version of the Omada Software Controller for Linux: Omada Software Controller Download
  2. Open a terminal and navigate to the directory where you downloaded the file. Extract the downloaded archive:

    tar zxvf Omada_SDN_Controller_v*_Linux_x64.tar.gz

  3. Change to the extracted directory:

    cd Omada_SDN_Controller_v*_Linux_x64

  4. Run the installation script with sudo:

    sudo bash ./

    The installation script will guide you through the setup process. Follow the on-screen instructions to complete the installation.

Step 5: Access the Omada Software Controller

Once the installation is complete, you can access the Omada Software Controller web interface by opening a web browser and navigating to http://server-ip:8088. Replace server-ip with the IP address of your Ubuntu server.Log in using the default credentials:

  • Username: admin
  • Password: admin

After logging in, you will be prompted to change the default password for security reasons.

Step 6: Configure Omada Devices

With the Omada Software Controller up and running, you can now start adding and configuring your TP-Link Omada devices.

  1. Connect your Omada devices (access points, switches, gateways) to the same network as the Ubuntu server running the Omada Software Controller.
  2. In the Omada Software Controller web interface, go to the “Devices” section and click on “Add Device”.
  3. Follow the on-screen instructions to discover and add your Omada devices to the controller. You may need to provide the device’s IP address or perform a network scan to find the devices.
  4. Once the devices are added, you can configure their settings, create wireless networks, set up VLANs, and manage access control through the Omada Software Controller interface.

Troubleshooting Tips

If you encounter any issues during the installation or while using the Omada Software Controller, here are a few troubleshooting tips:

  • Make sure your Ubuntu server meets the system requirements and has sufficient RAM and storage.
  • Verify that you have installed all the necessary dependencies, including Java and MongoDB.
  • Check the Omada Software Controller log files located in /opt/tplink/EAPController/logs for any error messages or clues about the issue.
  • Ensure that the required ports (8088 for web access, 29810-29813 for device communication) are open and not blocked by any firewall.
  • If the Omada Software Controller fails to start or crashes, try restarting the service using the command: sudo systemctl restart omada
  • For further assistance, consult the TP-Link support website or reach out to their customer support team.


Installing the TP-Link Omada Software Controller on Ubuntu provides a centralized management solution for your TP-Link network devices. By following this step-by-step guide, you can set up the controller on Ubuntu 20.04 or 22.04 and start configuring and monitoring your Omada devices efficiently.Remember to keep your Omada Software Controller and devices updated to the latest firmware versions for optimal performance and security. Regular backups of your controller configuration are also recommended to prevent data loss.With the Omada Software Controller in place, you can easily manage your network, customize settings, and ensure a seamless wireless experience for your users.