Setting Up CoovaChilli

Sep 14, 2016

CoovaChilli is a handy package that allows you to set up a captive portal splash page on your LEDE/OpenWRT device.

This guide assumes you already have a RADIUS set up, or are using a splash page provider, with the details needed.

SSH to your OpenWRT device

If you are using Windows then start PuTTY and click Session on the left side, select SSH from the options, and then enter in the IP Address of your OpenWRT box into the Host Name field.

Once you’ve done this just click on Open to start up the SSH connection.

If you are connecting via terminal, then just SSH to your OpenWRT device using the following command, where is your OpenWRT device’s IP address.


Installation is as simple as running the following two commands:

opkg update
opkg install coova-chilli


Before making changes to your config, it’s safest to stop Chilli for now. Run the following:

/etc/init.d/chilli stop /etc/init.d/chilli disable

Next we need to actually make some changes to the configuration. To do this, run the following command:

vi /etc/config/chilli

You will need to edit the config file using your details:

config chilli
# option disabled 1
# RADIUS account details
option radiusnasid   "xxxxxxxxx"
option radiussecret  "xxxxxxxxx"
option uamsecret  "xxxxxxxxx"
# WISPr settings
option locationname   "<human readible location name>"
option radiuslocationname  "<SSID>,<sub-ID>"
option radiuslocationid  "isocc=<cc>,cc=<idd>,ac=<ac>,network=<SSID>"
# Radius parameters
option radiusserver1
option radiusserver2
# LAN interface to put the hotspot
option dhcpif    br-lan
option dns1
option dns2
# Tunnel and Subnet
option tundev    'tun0'
option net
option uamlisten
option lease   86400
option leaseplus  600
# UAM parameters
option uamserver  ""
option uamuiport   4990
option uamanydns  1
#option uamaliasip
option uamaliasname   login
#option uamlogoutip
option nouamsuccess  1
# Hosts walled garden
option uamallowed ""
# Domains walled garden
option uamdomain ","
# Debug
option swapoctets  1
option interval   3600
# Chilli firewall rules
option ipup '/etc/chilli/'
option ipdown '/etc/chilli/'

Next confirm that the interface defined under Tunnel and Subnet in the config is up:


Finally, to confirm that everything is working, connect to your hotspot.

CT WiFi is a cloud based WiFi management platform for businesses. The firmware gives consumer-grade WiFi access points enterprise-like capabilities. Or you can utilise the captive portal solution with your existing infrastructure. Create a free account and check it here

Come join CT WiFi

Sign Up

Sign-up for CT WiFi, it's free for unlimited access points :)