Skip to content

TP-Link Omada

Compatibility

Social WiFi has been tested and is proven to work on the following configurations:

Omada Cloud-based Controller

  • Version 5.15 and above (tested up to 5.15.18.40)

Omada Software Controller

  • Version 5.15 and above (tested up to 5.15.18.40)

Access the administration panel

This guide assumes using the web based UI of the controller, which you can access by entering the IP address of the device in your browser. E.g. if the controller is installed on a local machine, enter: http://127.0.0.1:8088. Alternatively, if your device is managed from Omada Cloud, you can access the management UI from there.

The screenshots are based on a Cloud-based Controller version 5.15.18.40.

Wireless network configuration

If you don’t have a wireless network configured yet, go to Settings (1) → Wired&Wireless NetworksWLAN (2).

2025-03-06_15-30.png

Click ”+ Create New Wireless Network”.

2025-03-06_15-32.png

Configure as follows:

Network Name (SSID)e.g. “Social WiFi” (or any name that you want)
Device TypeEAP *
Band2.4GHz and 5GHz (or only one of them, if you prefer)
Guest NetworkEnable
SecurityNone (preferred for guest WiFi)
OWEUnchecked

2025-03-06_15-35.png

Click Apply.

RADIUS configuration

Go to Settings (1) → Network ProfileRADIUS Profile (2).

2025-03-06_15-36.png

Click ”+ Create New RADIUS Profile”.

2025-03-06_15-36_1.png

Configure as follows:

Namesocialwifi
Authentication Server IP35.205.62.147
Authentication Port31812
Authentication PasswordRADIUS Secret is available in Access Points tab of the Social WiFi Panel
RADIUS AccountingEnable
Interim UpdateEnable
Interim Update Interval600
Timeout3

2025-03-06_15-38_1.png

Accounting Server IP35.205.62.147
Accounting Port31813
Accounting Password:RADIUS Secret is available in Access Points tab of the Social WiFi Panel

2025-03-06_15-39.png

Click Save.

Portal configuration

Go to Settings (1) → Authentication → Portal (2).

2025-03-06_15-44.png

Click ”+ Create New Portal”.

2025-03-06_15-44_1.png

Use the following settings:

NameSocial WiFi
PortalEnable
SSID & NetworkSocial WiFi
Authentication TypeRADIUS Server
Authentication Timeout8 hours (change it, if you want to kick people sooner or later)
RADIUS Profilesocialwifi
NAS IDCan be anything, you can leave the default value
Portal Logout:Not Enabled
Authentication ModePAP
Portal CustomizationExternal Web Portal: http://login.socialwifi.com
HTTPS RedirectionNot Enabled (recommended)
Landing PageThe Original URL

2025-03-06_17-16.png

Click Apply.

Access Control configuration

After creating a Portal, switch to the Access Control tab on the left upper corner.

2025-03-06_15-46_1.png

Enable Pre-Authenticaton Access (1) and click on + Add (2).

2025-03-06_16-44.png

Configure as follows:

  1. Select URL
  2. Paste in the domain
  3. Click + Add New Pre-Authentication Access Entry

2025-03-06_16-35.png

Repeat this step for each domain below:

Mandatory

login.socialwifi.com
sw-login.com

Facebook remarketing pixel

connect.facebook.net
www.facebook.com

Google remarketing tag

www.googletagmanager.com
www.googleadservices.com
googleads.g.doubleclick.net

YouTube widget on login pages

Not supported, because TP-Link Omada controller does not support wildcards in URLs.

Facebook login

facebook.com
static.xx.fbcdn.net
external-frt3-2.xx.fbcdn.net

X (Twitter) login

twitter.com
api.twitter.com
x.com
api.x.com
pbs.twimg.com
abs-0.twimg.com
abs.twimg.com

LinkedIn login

www.linkedin.com
static-exp1.licdn.com
media-exp1.licdn.com
static.licdn.com

When finished, click Save.

2025-03-06_16-38.png

Next, click Apply.

2025-03-06_16-39.png

Add the access points to Social WiFi panel

The setup of the controller is now finished. The last step is to add all access points to the Social WiFi platform.

Go to Devices (1) in the menu on the left. We need to display the MAC address for each device. In order to do that, click on the three dots (2) icon and enable the MAC Address (3) checkbox.

The “MAC ADDRESS” column will be added. You will need those MAC addresses in the next step.

2025-03-06_16-48.png

Now, switch to Social WiFi Panel, go to Access Points tab, click the Add button and paste the MAC addresses of all of your access points controlled by the Omada controller. Click Create.

image_579690.png

Test the solution

Connect with the WiFi network. You should see a login page. Go through the login process and, once finished, you should have internet access. You should see first connections and authorizations in the Social WiFi Panel’s statistics section.

Firewall troubleshooting

Symptom: after connecting to the WiFi network, on the last step which is clicking the “Connect to the internet button” you’re not getting connected to the internet.

Solution: it might be the case that you have a firewall that blocks traffic between the WiFi device and the controller. You might either have explicit blocking rules on the firewall, or simply have separate VLANs for the guests and the controller and the traffic between them might be blocked as well. In this case you have to unlock specific ports. For example:

  • TCP 8088 (When the clients visit the Portal page via an HTTP connection)
  • TCP 8843 (When the clients visit the Portal page via an HTTPS connection)

More details on firewall configuration are available under this link:

https://www.tp-link.com/us/support/faq/3281/