Skip to main content
All CollectionsHotspot Setup GuideTP-Link
TP-Link Omada Controller (Self-Hosted) Setup Guide
TP-Link Omada Controller (Self-Hosted) Setup Guide
L
Written by Lawrence Soong
Updated this week

Information required for FansWiFi Manager

  • Mac Addresses of the APs

  • IP / Domain Name of Omada server

  • Admin username and password

Tested Model and Firmware Version

  • Access Point

    • AP Model: EAP110 (Standalone Mode, managed by EAP Controller)

      • EAP 115 Cluster Mode is NOT supported

      • EAP 120 is NOT supported

      • Standalone EAP without EAP Controller is NOT supported

    • Hardware version: 2.0

    • Firmware Version: 1.2.0 Build 20170915 Rel. 35864

  • EAP Controller Software:

    • Controller Firmware Version: 5.14.26.1

      • EAP Controller Software is required to be always on

Note that different models may have different interface

Connect TP-Link EAP to Omada Controller

Please refer to here

Setting on TP-Link EAP Controller

Step 1: Configure DNS Setting to the Core Router of the WiFi Network

Step 2: Configure the TP-Link EAP Local Controller

  • Start EAP Local Controller (Omada) software and login the management page

(2) Login.png

Step 3: Add FansWiFiAPI Admin account for API call by FansWiFi Portal Server (Will be used in Step 9)

  • a. Click "Account" on the left menu

    (3a) Click "Account".png

  • b. Select "User" on the top menu, then click "Add New User"

    (3b) Add new user.png

  • c. Configure with the following settings:

    • Administrator Type: Local User

    • User Name: <admin-id-you-prefer> (e.g. FansWiFiAPI)

    • Password: <password-you-set>

    • Role: Administrator

  • d. Click "Create"

    (3c) Create API admin user.png

Step 4: Configuration: SSID

  • You can skip this part if you already create SSID

  • a. Click "Dashboard" on the left menu

  • b. Select "Site List" on the top menu

  • c. Select a site from the list, and click "Launch"

    (4a) Open site.png

  • d. Click "Setting" on the left menu

  • e. Click "Wireless Networks" and choose "WLAN" on the left sub-menu

  • f. Click "Create New Wireless Network"

    (4cd) Create new network.png

  • g. Configure with following settings:

    • SSID Name: <ssid-name-you-prefer>

    • Device Type: EAP

    • Guest Network: Enable

    • Security: None

  • h. Click Apply

Step 5: Configuration: Portal

  • a. Click "Authentication" and "Portal" on the left sub-menu

  • b. Click "Portal" on the top menu

  • c. Click "Add a new portal"

    (5abc) Create new portal.png

  • d. Configure with following settings:

  • d. Click "Apply"

Step 6: Configuration: Access Control

  • a. Click "Access Control" on the top menu

    (6a) Access Control.png

  • b. Config with following settings

    • Pre-Authentication Access: Enable

  • c. Click "Add"

  • d. Add policies with the following configurations:

    • Click "IP Range" and enter the following IP Range

    • Click "Add New Pre-Authentication Access Entry" to add more "IP Range"

Policy Name

IP Range

Production 1

52.220.206.125/32

Production 2

52.220.226.90/32

Cloudflare 1

103.21.244.0/22

Cloudflare 2

103.22.200.0/22

Cloudflare 3

103.31.4.0/22

Cloudflare 4

104.16.0.0/12

Cloudflare 5

108.162.192.0/18

Cloudflare 6

131.0.72.0/22

Cloudflare 7

141.101.64.0/18

Cloudflare 8

162.158.0.0/15

Cloudflare 9

172.64.0.0/13

Cloudflare 10

173.245.48.0/20

Cloudflare 11

188.114.96.0/20

Cloudflare 12

190.93.240.0/20

Cloudflare 13

197.234.240.0/22

Cloudflare 14

198.41.128.0/17

  • e. Click "Save"

    (6d) Add IP Range.png

Step 7: Configuration: Radius

  • a. Click "Authentication" and "MAC-Based Authentication" on the left sub-menu

  • b. MAC-Based Authentication: Enable

  • c. RADIUS Profile: Click "Create New RADIUS Profile"

    (7a) Create New Radius.png

  • d. Configure with following settings for new RADIUS Profile:

    • Portal Name: FansWiFi Radius

    • Authentication Server 1

      • Authentication Server IP/URL: 103.6.85.240

      • Authentication Port: 1812

      • Authentication Password: social123

    • RADIUS Accounting: Enable

    • Interim Update: Enable

    • Interim Update Interval: 300 Seconds

    • Accounting Server 1

      • Authentication Server IP/URL: 103.6.85.240

      • Authentication Port: 1813

      • Authentication Password: social123

    • Click "Save"

    (7d1) Create FansWiFi Radius.png
    (7d2) Create FansWiFi Radius.png

  • e. Config the following settings for MAC-Based Authentication:

    • SSID: Select "Default [SSID]"

      • After that, it would automatically select the SSID that already created

    • RADIUS Profile: FansWiFi Radius

    • Click "Apply"

      (7e) MAC-Based Authentication.png

Step 8: Get the MAC address of the AP

  • You should see the MAC address at the bottom of AP

  • If you are not sure about the address, don’t worry.

    • Click "Devices" on the left menu

    • Click "Access Points" on the top menu.

    • You can see the MAC address of the AP. Choose the one you want to put into FansWiFi Admin Panel.

(7) Click "Device".png
(7) Device MAC Address.png

Step 9: Add AP to FansWiFi Admin Panel

  • Login to FansWiFi Admin Panel

  • (8a) Create.png

  • Click Settings -> Hotspots -> Create

    1. Venue: Select the venue of where your Access Point locates

    2. Hotspot Name: Name each Access Point to make it identifiable

    3. AP Type: Select “TP-Link EAP”

    4. Mac Address: Input unique MAC Address of each Access Point in your venue (Not controller)

  • Click Save

Step 10: Add API Profile in FansWiFi Admin Panel

  • a. Click "Venues & Login Portals" on the left menu

  • b. Click "Edit" on the venue where your TP-Link EAP would be put under

    (9a) Edit Venue.png
  • c. Click "Controllers"

  • d. Configure with the following settings:

    • TP-Link EAP Controller IP Address or URL: https://<your-controller-ip-address-or-url>

    • Port Number (Default: 8043): 8043

    • Admin Username: <your-admin-id> (Configured in Step 5, i.e. FansWiFiAPI)

    • Admin Password: <your-admin-password> (Configured in Step 5)

  • e. Click "Save"

(9b) Controller Setting.png
Did this answer your question?