Omada controller connection

Use the Omada ID, controller URL and site name from Controller Settings. WeefyBox stores credentials encrypted and tests the hotspot endpoint before guests are sent through it.

Guide 2 of 8 5-10 minute read Operator checklist

Before you change anything

Confirm the correct venue
Keep current settings handy
Test with one device first

Connect TP-Link Omada to WeefyBox

Setup

Open WeefyBox Setup and choose TP-Link Omada.
Copy the Portal URL and walled-garden domains.
In Omada, open Hotspot Manager > Operator.
Create a dedicated Hotspot Operator; do not share the main administrator.
Note the controller's omadacId from Global View > Settings > Controller Status.
Open Site > Settings > Authentication > Portal.
Create a portal and choose External Portal Server.
Select the guest SSID and paste the WeefyBox Portal URL.
Under Pre-Authentication Access, add every walled-garden domain.
Save and apply the portal profile.
Enter the controller URL, operator credentials, omadacId, and site in WeefyBox.
Select Save credentials, then Test my setup.
Forget the guest network on a phone and reconnect.
Complete the splash form and confirm internet access.
Check Portal debugger for a successful authorization.

Troubleshooting

| Symptom | Check | |---|---| | Splash never appears | Portal profile is attached to the correct SSID and gateway | | Splash works but no internet | Operator permissions, omadacId, site name, controller reachability | | iPhone works but Android fails | Add Google connectivity-check domains to Pre-Authentication Access | | Returning guests sign up again | Use fixed private MAC mode and enable a reasonable portal timeout | | Controller unreachable | Allow controller HTTPS from WeefyBox or provide a VPN endpoint |