# Omada Controller

Omada Controller is a Docker image that runs TP-Link's Omada software-defined networking controller to manage Omada wireless access points in self-hosted deployments. It is open source and self-hosted, installable on Docker Hub, Kubernetes (Helm), TrueNAS and Unraid.

Canonical page: https://ourlocalhost.com/app/448/omada-controller

## Description

Omada Controller is a Docker image that runs TP-Link's Omada software-defined networking controller to manage Omada wireless access points in self-hosted deployments.

## Platform availability

Available on 4 of 9 platforms: Unraid, TrueNAS, ZimaOS, Helm.

## Health score

21/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (GitHub repository no longer exists)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Light to run: 20 (6 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/mbentley/omada-controller/
- GitHub: https://github.com/mbentley/docker-omada-controller
- Kubernetes (Helm): https://artifacthub.io/packages/helm/geek-cookbook/omada-controller
- TrueNAS: https://apps.truenas.com/catalog/omada-controller/
- Unraid: https://ca.unraid.net/apps/omada-controller-14xwprb0gozqgz?q=omada-controller

## Common questions

### Which port must be reachable for Omada API calls?

The Omada API examples target port 8043, so port 8043 must be open on the controller address. Testing with curl's insecure flag may show a certificate warning.

### What network address setup should I consider when self-hosting the controller with a VPN?

A self-hosting example uses a nonstandard 10.132.x.x range to avoid conflicts with VPNs. It also keeps the controller on a server with a static IP.

### Can one software Omada controller manage multiple independent sites?

One user manages two completely independent sites on Omada Cloud Essentials. The source describes it as a hardware-free/software controller rather than a physical OC controller.

### How do I match Omada AP pre-release firmware to a controller/app version?

The pre-release firmware note lists minimum update firmware and recommended management controller/app versions by AP series. For EAP65x/EAP67x, the minimum update firmware is EAP65x and the recommended controller/app is EAP650.

## Alternatives

- OpenWISP: OpenWISP is a free and open-source platform for efficient IT network deployment, monitoring & management.
- UniFi Network: The UniFi® Network application is a Software-Defined Networking (SDN) platform, which provides an end-to-end system of network devices acro…
- omada: Omada is TP-Link's software controller for centrally managing its Omada routers, switches, and access points on a self-hosted network, with…

---
Source: Our Local Host (https://ourlocalhost.com/app/448/omada-controller), the self-hosted and open-source app directory.