How to install the Omada Controller on the Linux system(Controller V3 and below)

Configuration Guide
Updated 12-07-2023 09:25:16 AM 151668
This Article Applies to: 

Note: This article is based on the Ubuntu system.

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 Controller is a software which is used to manage the EAP. It supports both Windows and Linux system. This article will introduce how to install the software on Linux system to you.

This article is mainly divided into the following parts:

· Download and Extract;

· Installation;

· Running;

· Uninstallation.

1. Download and Extract

Please go to the official website of TP-Link to download the Omada Controller, we recommend you to download the latest version. Then we can find this download file in the Downloads file by default.

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


(1) Here are some explanations about the commands:

· “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!”, that means 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.

Here are some commands that can help you check/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 you start 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” in the web, 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 backup the database. The backup folder is /opt/tplink/eap_db_backup.

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 >

From United States?

Get products, events and services for your region.