How to Install an Omada Software Controller on a Linux System (Controller V3 and Below)

Configuration Guide
Updated 03-29-2024 14:49:13 PM FAQ view icon155151
This Article Applies to: 

Note: This article is based on Ubuntu.

This article is suitable for Omada Controller v3 and below.

For Omada SDN Controller v5.0.29 and above, please refer to FAQ 3272.

For Omada SDN Controller v4, please refer to FAQ 2917.

Omada Software Controller is software which is used to manage Omada products, such as EAPs. It supports both Windows and Linux operating systems.

This article will introduce how to install the software controller on a Linux system.

The steps in this article are divided primarily into the following parts:

· Download and Extract

· Installation

· Running

· Uninstallation

1. Download and Extract

Please go to the official TP-Link website to download the Omada Controller software. We recommend downloading the latest version. By default, once the download is complete, the file will be in your system’s Downloads directory.

Then please run Terminal as administrator, change the directory to Downloads, and extract the Controller software.


(1) Below are some explanations about the commands used:

· “su” means running the Terminal as administrator.

· “ls” is used to list documents in current file.

· “tar zxvf Omada_Controller_v3.2.1_linux_x64.tar.gz” means to unzip the compressed file. (“Omada_Controller_v3.2.1_linux_x64.tar.gz” is the file name of compressed file of Controller.)

(2) You can also right click the file and choose “Extract Here” to extract the Controller file.

2. Installation

After decompression, we can see another file named “Omada_Controller_v3.2.1_linux_x64” in Downloads.

Change directory to “Omada_Controller_v3.2.1_linux_x64” and we can see “” in the unzipped file.

Run “bash”.

When you see “Install Omada Controller succeeded!”, this indicates you have installed the Omada Controller successfully.

During installation, it will ask you whether to restore the database if there is any backup database in the folder /opt/tplink/eap_db_backup.


(1) Please install “jsvc” and “curl” first before you run the Omada Controller, or you cannot run it successfully. You can use “apt-get install jsvc” and “apt-get install curl” to install them.

(2) This software also needs to use netstat command, if your operation system doesn’t have net-tools (which includes netstat command), you can use “apt install net-tools” to install net-tools.

3. Running.

Below are some commands that can help check or change the status of Omada Controller.

· tpeap status -- show the status of Controller;

· tpeap start -- start the Omada Controller;

· tpeap stop --stop running the Omada Controller.

After starting the Omada Controller, you can browse URL http://localhost:8088 to access the web management page of the Controller.

When you see “Welcome to use Omada Controller” via web browser, please follow the wizard to set up your Omada Controller.

4. Uninstallation

If you want to uninstall the Omada Controller, you can go to the installation path /opt/tplink/EAPController and run the command “bash”.

During the uninstallation, you can choose whether to back up the database. The backup folder is /opt/tplink/eap_db_backup.


Looking for More

Is this faq useful?

Your feedback helps improve this site.


TP-Link Community

Still need help? Search for answers, ask questions, and get help from TP-Link experts and other users around the world.

Visit the Community >