TP-Link Omada + CaptiveWiFi Integration

TP-Link Omada.
CaptiveWiFi guest data.

Connect your TP-Link Omada network to CaptiveWiFi using RADIUS authentication and an external captive portal. Works with Omada Cloud, TP-Link Cloud, and self-hosted controllers including Hubox.

See it in action Setup guide
Works with Omada v4 and above
RADIUS authentication via CaptiveWiFi managed server
External portal URL — fully branded to your venue
Works with cloud-hosted controllers (Hubox recommended if no static IP)
CaptiveWiFi directly authenticates via Omada controller
Why CaptiveWiFi + Omada

Everything Omada
was missing.

Guest identity at the point of connection
Every device connecting to your Omada guest SSID is prompted to identify themselves. Name, email and marketing consent captured automatically.
Fully branded portal
Replace the default Omada portal with your own branded experience. Logo, colours, fonts and imagery — all matched to your venue.
GDPR-compliant data capture
Every guest record includes a full consent audit trail — timestamp, IP address and the exact consent wording. Built for UK and EU compliance.
Real-time visit intelligence
See who is in your venue right now. New guest or returning? CaptiveWiFi tracks visit frequency and behaviour automatically.
Automatic marketing triggers
Connect to Klaviyo, Mailchimp or your CRM. First visit, return visit, lapsed guest — each triggers the right campaign automatically.
Cloud and self-hosted controller support
Works with TP-Link Cloud, Omada Cloud, and self-hosted controllers. No static IP? Host your controller with Hubox for seamless operation.
Setup overview

Configure Omada.
Go live in minutes.

The Omada integration uses RADIUS authentication. CaptiveWiFi provides the RADIUS server credentials — contact our team to get started.

1
Create a new portal in Omada
In the Omada dashboard, go to Settings → Authentication → Portal. Create a new portal, enable it, and select RADIUS Server as the authentication type.
2
Add the CaptiveWiFi RADIUS profile
Create a new RADIUS profile. Set the Authentication Server IP and password (provided by CaptiveWiFi support). Port 1812, PAP authentication mode, RADIUS accounting disabled.
3
Set the external portal URL
Under Portal Customisation, select External Web Portal and enter your CaptiveWiFi portal URL: https://getonline.captivewifi.io/guest/<your-site-id>. Do NOT enable HTTPS Redirection.
4
Add pre-authentication access domains
Under Access Control, enable Pre-Authentication Access and add: getonline.captivewifi.io and captivewifi.fra1.digitaloceanspaces.com
5
Configure the CaptiveWiFi dashboard
In your CaptiveWiFi dashboard, select Omada as your hardware type and enter the external IP of your Omada controller. Must be a static IP — or use Hubox for cloud hosting.
RADIUS Configuration
Authentication Server IP: # From CaptiveWiFi support
Authentication Port: 1812
Authentication Password: # From CaptiveWiFi support
Authentication Mode: PAP
RADIUS Accounting: Disabled
NAS ID: YourVenueName # One word, no spaces

Portal URL: https://getonline.captivewifi.io
            /guest/<site-id>

# Contact support@captivewifi.io
# for RADIUS credentials
View the full setup guide →
FAQ

Common questions about
Omada + CaptiveWiFi.

Do I need a static IP address for the Omada integration?
Yes. CaptiveWiFi needs to communicate directly with your Omada controller, which requires a static IP address. If your venue does not have a static IP, we recommend hosting your Omada controller using Hubox — a cloud hosting service that resolves this issue without requiring a static IP from your ISP.
Where do I get the RADIUS server credentials?
The RADIUS server IP address and password are provided by CaptiveWiFi. Contact us at support@captivewifi.io or book a setup call and we will provide the credentials and walk through the configuration with you.
Which Omada version is supported?
CaptiveWiFi supports Omada v4 and above. The integration uses the RADIUS authentication method available in Omada v4+.
Is this GDPR compliant?
Yes. CaptiveWiFi is fully GDPR and UK GDPR compliant. Every guest record includes a consent timestamp, IP address and opt-in status. A full DPIA is available on request.
Other integrations

CaptiveWiFi connects to
your whole stack.

UniFi
WiFi Hardware
Cisco Meraki
WiFi Hardware
FortiGate
Firewall / WiFi
Ruijie
WiFi Hardware
Get started

Ready to connect your
Omada network?

Works with Omada Cloud and self-hosted controllers. RADIUS credentials provided by CaptiveWiFi.

See it in action