Skip to main contentSkip to search
Skip to main content

CoovaChilli

CoovaChilli is an open-source captive portal / access controller (the fork of ChilliSpot) that enforces WiFi access by redirecting unauthenticated clients to an external UAM splash page and authorizing them via RADIUS — in this setup, IronWiFi hosts both the splash page and the RADIUS server. Configuration is done in

/etc/chilli.conf
by pointing
radiusserver1
,
uamserver
, and
radiussecret
at IronWiFi.

Prerequisites

In IronWiFi Console (complete these first):

  1. Create a Network in IronWiFi Console
  2. Create a Captive Portal with the appropriate vendor
  3. Note your RADIUS settings and Splash Page URL

In CoovaChilli:

  • Administrative access to CoovaChilli device
  • Network connectivity to IronWiFi RADIUS servers

Device Configuration

RADIUS Settings

Configure your device with:

SettingValue
Primary Server
{Primary IP from IronWiFi}
Auth Port
{AUTH_PORT}
Acct Port
{ACCT_PORT}
Shared Secret
{Your shared secret}

Captive Portal

  1. Enable external captive portal
  2. Set splash page URL from IronWiFi
  3. Configure walled garden to include
    107.178.250.42

Walled Garden

Add these entries for pre-authentication access:

Required for IronWiFi:

  • 107.178.250.42
    (IronWiFi splash page)
  • DNS servers

Authentication Provider Domains:

If using social login providers, add the following domains to your walled garden:

ProviderRequired Entries
Google
*.google.com
,
*.googleapis.com
,
*.gstatic.com
,
accounts.google.com
Facebook
*.facebook.com
,
*.fbcdn.net
,
connect.facebook.net
,
facebook.com
Twitter
*.twitter.com
,
*.twimg.com
,
twitter.com
LinkedIn
*.linkedin.com
,
*.licdn.com
Microsoft
*.microsoft.com
,
*.microsoftonline.com
,
*.live.com
,
login.live.com

WPA-Enterprise

For 802.1X authentication:

  1. Set security to WPA2-Enterprise
  2. Configure RADIUS server details
  3. Test with a known user

Troubleshooting

IssuePossible CauseSolution
Portal not appearingWalled garden misconfiguredCheck walled garden includes
107.178.250.42
and splash URL is correct
Authentication failingRADIUS settings incorrectVerify RADIUS IP, ports, and shared secret match IronWiFi Console
No internet after authFirewall or VLAN issueCheck firewall rules and VLAN settings

Getting Help

For device-specific questions:

Shared configuration

Was this page helpful?