WiFiLAN Quick Start Guide

This article explains the basic steps required to setup WiFiLAN for simple click-through login page. Admin can follow these instructions to do a quick setup to check authentication system and configuration of the gateway/controller.

Basic WiFiLAN setup consist of following steps -

  1. Create a new hotspot
  2. Add a login plan
  3. Create a click-through captive portal
  4. Configure the gateway/controller
  5. Test the login process

Step 1: Create a new hotspot

  1. Click Add New Hotspot tab under the Hotspot link of Authentication menu.

New Hotspot Field Descriptions



Fields and Buttons


Hotspot Plan

Select the plan for the hotspot from the Hotspot Plan drop down menu. The hotspot plan decides the size of your hotspot and you will be billed based on the selected plan. 

If in doubt, select 100 concurrent user plan

Hotspot Name

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


Enter the address of the location in the Address field.


Enter the name of the city in the City field.


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


Select the name of the country from the Country drop down list.


Enter the zip code of the location in the Address field.



Latitude automatically gets populated when you enter the city, state, country, zip code details.


Longitude automatically gets populated when you enter the city, state, country, zip code details.


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

Is Paid

Select the Is Paid check box if the location is a paid location.

Auto Mac Register

Select Auto Mac Register check box to get direct internet access when the user is in that location for the second time, or any time after that.

Gateway Information

Device Type

Select the type of the controller associated for the hotspot from the Device Type drop down menu.

Public IP Address

Enter the Public IP address in the Public IP Address field. If you using a broadband connection with dynamic IP, enter the current IP address. You can find the current IP by going to www.whatismyip.org.


Enter the secret as "secret" in the Secret field.


The NAS ID field is auto generated by the system. You will need this field while configuring the gateway/controller settings.

Mac Address

Enter the WAN MAC address of the device in the Mac Address field.


Enter a short description of the device in the Description field.


Click the Submit button to save the changes.


Step 2: Create a login plan

Login plan decides what restrictions/policies you are going to apply on the users who are going to access the hotspot service. The login plan is applicable for both free and paid WiFi access. For example, if you want to offer one hour of free WiFi service every day, then you need to create a free plan with the necessary time restrictions.

Once the login plans are created, they need to be used along with captive portal. There are different type of login plans offered to the user. For more description, please refer to Understanding different plans.

Adding click-through plan

To add a click-through plan, click on Billing -> Plan option. Click on New Plan tab. Select the options as shown below. These options are for plan with time restrictions. You can select bandwidth option as well.

On the next page, enter the details of your plan.


Save the above plan.


Step 3: Creating Captive Portal

Once the click-through plan is added, you need to click on the Portal -> Add option. This page will guide you to create a click-through portal using the plan created above.

Step 1:

Select the location/hotspot for the captive portal.


Step 2:

Select the type of hotspot controller/gateway for the captive portal. This option will decide the login script for the portal. Please select the correct option.

If you don't have the model listed, select the one closest to that model. Most vendors have similar login script for their gateways.

Next select your portal language. English is set by default.

Next select the type of portal. In this case, select the click-through option. You will also need to select the plan associated with the portal. The plan will decide the restrictions for free access.


Next, upload your logo and partner logo. If you want to apply a background image, please select the background image option and upload your background image.


Lastly, select the Terms & Conditions option if you want the user to accept T&C before getting access. Upload your T&C in the text area. Enter the footer text.

If you want to display the support number, select the option and enter your support number.

Finally, enter the welcome URL (URL displayed on successful login). This is a mandatory field.

Save the portal. Once the portal is saved, a URL will be generated on the List portal page. You need to use this URL when configuring your respective controller/gateway.


Step 4: Configure your gateway/controller

The next step is to configure the gateway/controller with hotspot settings so it works with WiFiLAN server. Each gateway/controller is different. Please refer to our gateway configuration guides for configuring gateway from specific vendor


Step 5: Testing the setup

The final step is to test the whole setup. You will need to connect to your gateway/controller using WiFi or wired connection. If you setup is correct, you will get redirected to the captive portal (login page) and you should be able to login.


Troubleshooting Steps:

1. You get the login page but are unable to login

Most likely your gateway/controller is not correctly configured. Please check the RADIUS server IP and shared secret. The shared secret in your gateway configuration should exactly match the secret entered in WiFiLAN.

Also make sure that you have entered correct public IP of your Internet connection. If you are on dynamic IP, please get your current IP address by going to www.whatismyip.org.

please note that if your dynamic IP changes, then you need to ensure that you enter the correct MAC address of your router and set the NAS ID in your gateway/controller. 

WiFiLAN checks either the IP address, MAC address or NAS ID during the login process. If anyone of them matches, the login request is processed by the RADIUS server.

2. The login page appears to hang or shows a timeout message. 

This usually happens if you have not configured the welcome URL or post-login landing page correctly in your controller/gateway. If you are using WiFiLAN designed login pages, the welcome URL needs to be set to the following one -

The real welcome URL (e.g. www.google.com) needs to be configured in the portal section.
3. Some devices are having problem with login
It has been observed that few mobile devices with the popup browser (window that pops up automatically) have problems with javascript / jquery. If you experience this, we recommend that you add the following URLs in your controller/gateway passthrough URLs to bypass the popup browsers:
Apple popup:

Andriod popup:


Please send an email to support@wifi-soft.com if you have login issues. Our support team will help you with the debugging.


Have more questions? Submit a request


Please sign in to leave a comment.