Installation on an OpenWrt device

1. System requirements
- A wireless router with OpenWrt installed
(Current supported openwrt v19.** & v23.**)

How to install openwrt? ....Click here

- Wifidog


Download Putty SSH command client.
Help to connect Router & send command
You can try to install Wifidog by running the following command:

wget -O - '' | sh
sh /tmp/

Asking Gateway ID you can get from login account and hotspot page
then reboot router
Make your wireless router connected to the Internet firstly.
Configure and enable wireless network (create an available AP).


Openwrt opkg update

Advance Installation ....Click here

Openwrt opkg update

Openwrt install wifidog

Mannually send command to putty
for openwrt v19.**

opkg update
opkg install wifidog opkg

for openwrt v23.**

opkg update
opkg install wifidog
opkg install iptables-zz-legacy

Or You can install wifidog direct from router admin page.
Login router
Go to System > Software - Click -> Update List after that
Type "Wifidog" filter package box to search.
From list install wifidog.

2. Create your Hotspot in the Web Control Panel
Login into the Web Control Panel by accessing our website.
Click “Hotspots”, and then click “add a New Hotspot” in the page displayed. Follow the instructions and fill all the right items, click submit.
You can find out the Hotspot ID generated of the Hotspot you just created. Remember it, it will be used in next steps.

3. Configure the HotSpot Builder Utility package
Connect a PC to your wireless router, and SCP into your wireless router from the PC.
Set it up by running the following application
Download WinSCP and connect router ip

Winscp Openwrt connect

Openwrt wifidog config

Open router location /etc/wifidog.conf
Copy and Paste the following configuration

#Gateway ID is use from Hotspot ID

ExternalInterface eth0
GatewayInterface br-lan
AuthServer {
HTTPPort 80
SSLAvailable yes
Path /
HTTPDMaxConn 253
ClientTimeout 10
FirewallRuleSet global {
#FirewallRule allow to
FirewallRuleSet validating-users {
FirewallRule allow to
FirewallRuleSet known-users {
FirewallRule allow to
FirewallRuleSet unknown-users {
FirewallRule allow udp port 53
FirewallRule allow tcp port 53
FirewallRule allow udp port 67
FirewallRule allow tcp port 67
FirewallRule block udp port 8000
FirewallRuleSet locked-users {
FirewallRule block to

#TrustedMACList 00:00:DE:AD:BE:AF,00:00:C0:1D:F0:0D


wifidog config

Save and close.

Go to /etc/init.d/wifidog
Open wifidog and add (sleep 10) as image below.
wifidog config
It help good performance captive portal.
Save and reboot.

Wifi Hardware Installation Diagram

Openwrt Hardware Installation Diagram
For more captive portal information and Got troubles in installation? Contact Us.
We support Teamviwer and whatsapp +14014020325.


The captive portal is the web page the user sees before accessing a public Wi-Fi network. It is also known as splash page, login page, splash portal and landing page.


A captive portal can also be used to provide access to enterprise or residential wired networks, such as apartment houses, hotel rooms, and business centers.


Most captive portal is wifi system works in routers.