# EAPcontroller

EAPcontroller is a self-hosted network services app. Self-hosted TP-Link EAP (Easy Access Point) Controller for centrally managing hundreds of TP-Link Omada EAP wireless access points across multiple sites from a single server location. It is open source and self-hosted, installable on Docker Hub, Proxmox and Unraid.

Canonical page: https://ourlocalhost.com/app/755/eapcontroller

## Description

Self-hosted TP-Link EAP (Easy Access Point) Controller for centrally managing hundreds of TP-Link Omada EAP wireless access points across multiple sites from a single server location.

## Platform availability

Available on 2 of 9 platforms: Unraid, Proxmox.

## Health score

21/100 (Low), based on 4 of 4 factors.
- Maintained: 0 (last commit 1713 days ago)
- Popular: 25 (16 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/mace/eap-controller/
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=omada
- Unraid: https://ca.unraid.net/apps/eapcontroller-02vulcy01sfiwm?q=EAPcontroller
- GitHub: https://github.com/macexx/EAP-Controller

## Common questions

### Why won’t MongoDB start when /config is mapped to Unraid shfs, mergerfs, or another fuse mount?

MongoDB does not start if the /config directory is mapped to a fuse mount such as shfs or mergerfs. Use a direct host path instead.

### How do I install a custom certificate for the controller’s HTTPS interface?

Stop the container, place the certificate in /config/cert, name it mydomain.p12, and set the password to tplink.

### What container network mode should be used for EAP discovery?

Run the container with host networking or a macvlan network so it can find the APs.

### Are the controller’s admin username and password restored from a backup?

No, restoring a backup restores AP, SSID, and other settings, but not the base controller username or password.

### Which ports serve the controller web UI?

The web UI is served on port 8088 for HTTP and port 8043 for HTTPS.

### Can more than one Omada controller be used on the same LAN?

No, only one Omada controller is allowed on the same local area network, and an EAP can only be managed by one controller.

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