Configuring Ubiquiti UniFi Controller

Purpose of this document

  • This document should be used in conjunction with UniFi user guide for configuring your UniFi gateways in WiFiLAN. Please refer to WiFiLAN administrator guide and UniFi user guide for detail information.
  • It assumes that the user has basic knowledge of networking including configuring subnet mask, RADIUS setting, default gateway and DNS configuration.
  • In order to configure UniFi you will need a static IP address, Subnet mask, default gateway and DNS information given to you by your Internet Service Provider. Please keep this information handy while setting up your gateway.
  • Configuring WiFiLAN you will need the AP MAC address, RADIUS secret and public IP address of your UniFi gateway.
  • You need an active WiFiLAN account. Please contact Wifi-soft sales to create your WiFiLAN account.


WiFiLAN Setup

Add Hotspot:

  1. Open a web browser and type and press Enter. Welcome screen of WiFiLAN appears.
  2. Click the Hotspot link under Authentication section.
  3. Click the Add New Hotspot tab. The New Hotspot page appears.

Fields and Buttons


Hotspot Plan

Select the plan for the hotspot based on number of concurrent users.

Hotspot Name

Enter the name of the hotspot in the Hotspot Name field.


Enter the address of the location in the Address field.


Enter the name of the city of the location in the City field.


Select the name of the state from the State drop down list.

Zip Code

Enter the zip code of the location in the Zip Code field.


Enter the Latitude of the location in the Latitude field.


Enter the Longitude of the location in the Longitude field.


Select the type of location from the Type drop down menu.

Is Paid

Click Is Paid check box if the location is charged.

Auto MAC Register

Select Auto MAC Register check box to enable the auto login feature in WiFiLAN.


Click Submit button to save the changes.

Then, enter the details of the gateway


Fields & Buttons


Device Type

Select UniFi from the Device Type drop down menu.

Public IP Address

Enter Public IP Address of the gateway in the IP Address field. 

Note: For successful user authentication, the UniFi controller should be reachable from the captive portal server that you are going to configure in the UniFi.

If you don't know the public IP, connect to your modem and type It will display your current public IP address.


Enter the RADIUS secret configured in the gateway in the Secret field.


Enter an Unique NAS Identifier for the device in the NAS ID field.

MAC Address

Enter the MAC address of the WAN port in the MAC Address field.


Enter a short description for the device

Once the hotspot is added, WiFiLAN will be ready to start accepting AAA requests from the gateway/controller. When the hotspot is added, WiFiLAN will automatically add a user group for that hotspot. The space in the hotspot name is replaced with underscore for the user group name.

Now you will need to design a captive portal for your hotspot and generate a URL that can be configured in the gateway/controller's settings.

Please refer to the captive portal design guide for steps to design your custom captive portal.


UniFi Setup

It is assumed that you have properly connected your UniFi gateway with broadband connection that has a static public IP address. Your UniFi gateway admin interface is accessible either via LAN interface or via public WAN interface.

  1. Login to UniFi dashboard.
  2. Click on Settings button, on the vertical sidebar for options located towards bottom as shown in the screenshot below. Go to Site section and create a site with the appropriate information.1.jpeg
  3. Go to Wireless Networks section. And provide the appropriate information as shown in below screenshot.2.jpeg
  4. Go to Guest Control section. And provide the appropriate information as shown in below screenshot. 3.jpeg
  5. Here, UniFi controller setup is complete.
  6. Further you need to connect to the UniFi SSID that you have configured, after connecting to the SSID the controller will try to redirect you to the captive portal URL like below, but it will not success.<SitenId>/index
  7. Here, you need to contact WiFi-soft support and provide following attributes 
    1. SiteId,
    2. UniFi admin username and password
    3. UniFi dashboard link 
      that WiFi-soft will configure in the captive portal server. After that you will be able to properly redirect to the captive portal that you have configured in the WiFiLAN for that hotspot.
Have more questions? Submit a request


Please sign in to leave a comment.