How to Configure Omada Controller as a Windows Service(above Controller 2.5.4)

Configuration Guide
Actualizado08-03-2021 05:53:11 AM 264029
Este artículo se aplica a: 

This document is suitable for Omada Controller V2.5.4 or above. For Omada Controller V4.1.5 or above, please refer to FAQ 2915.


This document introduces how to configure Omada Controller as a Windows Service by using NSSM.


1. A computer with the Omada Controller installed already.

2. Download the NSSM – the Non-Sucking Service Manager (


1. Extract nssm.exe to a convenient location, here I use “C:\Program Files (x86)\TP-LINK” as e xample.

2. Make sure you have ran Omada Controller before, or you can just keep Omada Controller running during this operation.

3. Run Windows Command Line as administrator and cd to the path you placed nssm.exe. Here is the C:\Program Files (x86)\TP-LINK.

4. Type nssm install “Omada Controller” to create a new Service using nssm. 

Set the following parameters as listed below:



C:\Program Files (x86)\TP-LINK\EAP Controller\jre\bin\java.exe

Startup directory:

C:\Program Files (x86)\TP-LINK\EAP Controller\jre\bin\


-server -Xms128m -Xmx1024m -XX:MaxHeapFreeRatio=60 -XX:MinHeapFreeRatio=30 -XX:+HeapDumpOnOutOfMemoryError -Deap.home="C:\Program Files (x86)\TP-LINK\EAP Controller" -cp "C:\Program Files (x86)\TP-LINK\EAP Controller\lib\*" com.tp_link.eap.start.EapMain


Display name:

Omada Controller by default


Add one if you want

Startup type:


Log on

Local System account and select “Allow service to interact with desktop”


set scriptDir="C:\Program Files (x86)\TP-LINK\EAP Controller\bin"

set eapHome="C:\Program Files (x86)\TP-LINK\EAP Controller"



5. Click Install service and will show you the successful note.

6. After the Omada Controller service is successfully set up, please restart your computer and the Omada Controller service will startup automatically. Please check on Windows Task Manager to see if the java.exe and mongod.exe are running properly. Then you can type or to login to the Omada Controller’s Web management page.



1. It is not recommended that you put nssm.exe in the installation path of the Controller, otherwise it will disappear when you upgrade the Omada Controller.

2. When you are going to update the Controller, please remember to stop the service first, or the process will be denied.

3. Run Windows Command Line as administrator and and cd to the path you placed nssm.exe. Type in the following commands to manage the service.

(1) nssm edit “Omada Controller”

(2) nssm start “Omada Controller”

(3) nssm stop “Omada Controller”

(4) nssm restart “Omada Controller”

(5) nssm status “Omada Controller”

(6) nssm remove “Omada Controller”

Looking for More

¿Es útil esta faq?

Sus comentarios nos ayudan a mejorar este sitio.

De United States?

Obtener productos, eventos y servicios para su región.