How to install the Omada Controller on the Linux system

Configuration Guide
Aktualisiert 06-27-2022 03:54:45 AM 133306
Dieser Artikel gilt für: 

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.

Finden Sie diese FAQ hilfreich?

Mit Ihrer Rückmeldung tragen Sie dazu bei, dass wir unsere Webpräsenz verbessern.

Von United States?

Erhalten Sie Produkte, Events und Leistungen speziell für Ihre Region