omada-controller

omada-controller

Docker app from Stevie Zylstra's Repository

Overview

TP-Link Omada SDN Software Controller — centrally manages Omada EAPs, switches, and gateways. Community Docker image maintained by mbentley. Bundles its own MongoDB so no separate DB container needed. Defaults to host networking for reliable device discovery and adoption.

Install omada-controller on Unraid in a few clicks.

Find omada-controller in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for omada-controller Review the template variables and paths Click Install

Download Statistics

22,560,501
Total Downloads
726,047
This Month
456,252
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
mbentley/omada-controller:latest
Last Updated2026-07-23
First Seen2020-11-20

Runtime arguments

Web UI
https://[IP]:8043
Network
host
Shell
bash
Privileged
false
Extra Params
--stop-timeout 60 --ulimit nofile=4096:8192 --cpus 2 --memory 4g --memory-swap 5g

Template configuration

TimezoneVariable

Your timezone.

Target
TZ
Default
America/Denver
Value
America/Denver
PUIDVariable

User ID. 99 = nobody on Unraid.

Default
99
Value
99
PGIDVariable

Group ID. 100 = users on Unraid.

Default
100
Value
100
Override Web Config on RestartVariable

Set to true to re-apply env var port changes on every restart instead of just first boot.

Target
WEB_CONFIG_OVERRIDE
Default
false
Value
false
Data PathPathrw

Persistent storage for controller database and config.

Target
/opt/tplink/EAPController/data
Default
/mnt/user/appdata/omada-controller/data
Value
/mnt/user/appdata/omada-controller/data
Logs PathPathrw

Controller log files.

Target
/opt/tplink/EAPController/logs
Default
/mnt/user/appdata/omada-controller/logs
Value
/mnt/user/appdata/omada-controller/logs
HTTPS Management PortPorttcp

HTTPS port for controller web UI.

Target
8043
Default
8043
Value
8043
HTTP Management PortPorttcp

HTTP port for controller web UI and portal.

Target
8088
Default
8088
Value
8088
HTTPS Portal PortPorttcp

HTTPS captive portal port.

Target
8843
Default
8843
Value
8843
EAP Discovery Legacy UDPPortudp

Legacy EAP discovery. Required for older Omada devices.

Target
19810
Default
19810
Value
19810
App Discovery UDPPortudp

Omada app discovery port.

Target
27001
Default
27001
Value
27001
Device Discovery UDPPortudp

Primary EAP device discovery. Do not change.

Target
29810
Default
29810
Value
29810
Manager V1 TCPPorttcp

EAP management port v1.

Target
29811
Default
29811
Value
29811
Manager V2 TCPPorttcp

EAP adoption port.

Target
29812
Default
29812
Value
29812
Manager V3 TCPPorttcp

EAP management port v3.

Target
29813
Default
29813
Value
29813
Manager V4 TCPPorttcp

EAP management port v4.

Target
29814
Default
29814
Value
29814
Device Monitor TCPPorttcp

Device monitor port.

Target
29815
Default
29815
Value
29815
Remote Control TCPPorttcp

Remote control port.

Target
29816
Default
29816
Value
29816
Data Transfer TCPPorttcp

Data transfer port.

Target
29817
Default
29817
Value
29817