Appearance
Ruckus Setup
Ruckus Unleashed works with CaptiFi through a Hotspot (WISPr) service and RADIUS. Guests joining your guest WiFi are sent to your CaptiFi splash page. When they finish it, the page signs them in to your Unleashed network, and Unleashed checks with CaptiFi's RADIUS server before letting the device online.
This guide covers Ruckus Unleashed, set up in the Unleashed web interface plus one short command over SSH. Access points managed by SmartZone, ZoneDirector or RUCKUS One aren't covered by this guide. If yours are, email hello@captifi.io before you start.
Important
Enter the portal URL, RADIUS values and shared secret exactly as your CaptiFi dashboard shows them. A wrong value stops guests getting online.
Prerequisites
- Ruckus access points running Unleashed, with admin access to the Unleashed web interface
- A computer on the same network that can open an SSH session to your Unleashed master access point (Terminal on a Mac, PowerShell or PuTTY on Windows)
- A CaptiFi account at my.captifi.io with a Ruckus venue, which gives you the portal URL, the RADIUS shared secret and the NAS identifier
Overview
- Create the venue in CaptiFi to get your portal URL and RADIUS values
- Add CaptiFi's RADIUS servers in Unleashed, one for authentication and one for accounting
- Create the hotspot service that sends guests to your splash page
- Create the guest WLAN on that hotspot service
- Set the guest WLAN's NAS-ID over SSH, so CaptiFi knows which venue each guest is at
- Test with a phone
Step 1: Create the venue in CaptiFi
- Log in to my.captifi.io
- In the set-up wizard, under How do guests connect to WiFi?, choose Ruckus Unleashed and click Continue
- Give the controller a name under Controller name, then set up your venue
- The wizard's Activate your WiFi step shows your portal URL, the allowed domains and the Start Page address with copy buttons. Under them, the RADIUS server block lists the server's IP address, Authentication port, Accounting port, NAS identifier and Shared secret for your venue, with a line saying where they go in Unleashed, and then the command lines for the NAS-ID in Step 5, already filled in for your venue. The secret is masked until you click Show, and Copy works either way

After set-up, the same values are on the venue's Connection page: on My Venues, open More on the venue's card, choose Connection and look under Controller settings.
If your account is already set up and you are adding a Ruckus venue, go to My Venues, click Add venue and choose Ruckus. The Set up your controller step that follows shows the same values, RADIUS block included, with connection checks that tick off as your controller and first guests reach CaptiFi. Done unlocks once they are green.
Your portal URL has this form (replace YOUR_SITE_ID with the site ID from your dashboard):
https://app.captifi.io/guest/ruckus?site_id=YOUR_SITE_IDYour access point automatically appends the guest's MAC, SSID and other details to this URL, so do not add anything after site_id.
Connection checks in the set-up wizard
The WiFi step of the wizard lists three checks under Connection checks, below the RADIUS values and the NAS-ID lines: Controller sending RADIUS traffic, Guest device reached the splash page and Guests completing the splash page. Once Steps 2 to 5 are done, join the guest SSID with a phone. The first turns green when your controller's first RADIUS request arrives, the second when the sign-in page loads and the third when the form is completed. Until a phone reaches the sign-in page, the third shows a grey question mark and Waiting on the check above. They update every 10 seconds while the page is open, and Finish setup unlocks once they are green.

Step 2: Add CaptiFi's RADIUS servers
In Unleashed, go to Admin & Services → Services → AAA Servers and click Create twice, once for each row below. Unleashed takes an IP address here, and 46.62.168.7 is CaptiFi's RADIUS server (radius.captifi.io).
| Name (your choice) | Type | Auth Method | IP Address | Port | Shared Secret |
|---|---|---|---|---|---|
| CaptiFi-Auth | RADIUS | PAP | 46.62.168.7 | 1812 | Your shared secret |
| CaptiFi-Acct | RADIUS Accounting | 46.62.168.7 | 1813 | Your shared secret |
The shared secret is on the wizard's Activate your WiFi step, and under Controller settings on the venue's Connection page in My Venues.
Step 3: Create the hotspot service
Go to Admin & Services → Services → Hotspot Services and click Create (you can also create it from the guest WLAN in Step 4 with the + next to Hotspot Services).
On the General tab:
Name:
CaptiFiWISPr Smart Client Support: None
Login Page: your CaptiFi portal URL from Step 1
Start Page: redirect to the following URL, your venue's connected page:
https://app.captifi.io/site/YOUR_SITE_ID/connectedYour dashboard shows this address, with your site ID, as the Start Page in the wizard and under Controller settings. Guests land on this page once they are online, and it sends them on to the redirect URL set on your venue. With the other option (the URL the user intends to visit) iPhones can end on a blank screen after signing in.
On the Authentication tab, choose the CaptiFi-Auth server for authentication and CaptiFi-Acct for accounting.
On the Walled Garden tab, add these three entries so guests can load the splash page before they sign in:
| Walled garden entry |
|---|
app.captifi.io |
captifi.io |
46.62.168.7 |
Click OK to save.
No redirect-back URL
There is no separate redirect URL to configure. The splash page signs the guest in to Unleashed itself, and Unleashed then asks CaptiFi's RADIUS server.
Step 4: Create the guest WLAN
Go to Wi-Fi Networks and click Create (or Edit an existing guest network):
- Name: your guest network name, for example
The Anchor Guest WiFi - Usage Type: Hotspot Service
- Authentication Method: Open
- Encryption Method: None
- Hotspot Services:
CaptiFi
Click OK to save.
Step 5: Set the guest WLAN's NAS-ID
Unleashed sends a NAS-ID with every RADIUS request, and CaptiFi uses it to recognise your venue. By default the WLAN sends its own BSSID, which CaptiFi can't match to a venue, so guests would see the splash page and never get online. The Unleashed web pages have no NAS-ID setting, so this one step is done over SSH.
Use the IP address you open the Unleashed web interface on (your master access point)
Open an SSH session to it. On a Mac or Linux:
ssh -o HostKeyAlgorithms=+ssh-rsa admin@UNLEASHED_IP(Unleashed offers an older key type that current SSH clients refuse unless asked; PuTTY on Windows connects without the option.)
At Please login:, enter your Unleashed admin username and password
Open the guest WLAN by entering these lines one at a time. Your dashboard shows them under NAS-ID on the guest WLAN as 1. Open the guest WLAN, with your WiFi network name already filled in (wizard step Activate your WiFi, or Controller settings on the venue's Connection page); otherwise replace the name with your guest WLAN's exact name from Step 4:
enable config wlan "The Anchor Guest WiFi"Check the reply. Unleashed should say the WLAN service has been loaded. If it says has been created, the name matches none of your WLANs and Unleashed has started a new one: type
abort(it replies No changes have been saved.) and open the WLAN again with its exact name, capitals and spaces includedOnce the WLAN has loaded, enter these lines, shown in your dashboard as 2. Set the NAS-ID and save. Otherwise replace
YOUR_NAS_IDENTIFIERwith the NAS identifier from your dashboard:nasid-type user-define YOUR_NAS_IDENTIFIER end exit exitAfter
end, Unleashed replies The WLAN service ... has been updated and saved.
Step 6: Test
- Join the guest WiFi with a phone
- The CaptiFi splash page should open by itself. If it doesn't, open a browser and visit any
http://site, for examplehttp://example.com - Complete the form. After a few seconds the phone is online and shows the connected page, then your venue's redirect URL
- Check Guest Visits in your CaptiFi dashboard for the new guest
Troubleshooting
| Issue | Solution |
|---|---|
| Splash page not appearing | Check the guest WLAN's Usage Type is Hotspot Service with the CaptiFi service selected, and the Login Page matches your portal URL exactly |
| Splash page loads without its styling, or not at all | Check the walled garden has app.captifi.io, captifi.io and 46.62.168.7 |
| Guests complete the splash page but never get online | Check Step 5: the guest WLAN's NAS-ID must be your NAS identifier. Then check Step 2: auth method PAP, port 1812, and the hotspot service's Authentication tab set to that server |
| Guests get online but see a blank screen afterwards | Set the hotspot service's Start Page to redirect to your connected page, https://app.captifi.io/site/YOUR_SITE_ID/connected (Step 3) |
| Guests are refused after the splash page | The shared secret doesn't match. Copy it again from your CaptiFi dashboard into both AAA servers |
| No session data in CaptiFi | Select the CaptiFi accounting server on the hotspot service's Authentication tab |
| HTTPS sites not triggering redirect | Guests may need to visit an http:// site first (for example http://example.com) to open the splash page |
Vouchers and Paid WiFi
WiFi vouchers work on Ruckus: the guest types their code, and the access points keep them online for the code's time. Paid WiFi is not available on Aruba Instant On, FortiGate, MikroTik or Ruckus networks. If you try to switch it on for a Ruckus venue, my.captifi.io tells you it is not available.
Multiple Sites
If you manage several Ruckus Unleashed networks:
- Each venue can have its own splash page design in CaptiFi
- Each venue has its own portal URL and NAS identifier, so each Unleashed network needs its own hotspot service and its own NAS-ID
- To use one Login Page for every venue, enter
https://app.captifi.io/guest/ruckuswith nosite_idand add each venue's access points under WiFi Access Points, Add access point. Unleashed sends the access point's MAC asmac, and CaptiFi uses it to find the venue. The NAS-ID and Start Page stay per venue. See One Portal Address for Several Venues - Manage per-venue settings in My Venues on your CaptiFi dashboard (each additional CaptiFi venue beyond the one included in your plan is charged at your currency's extra-venue rate)
Next Steps
Need Help?
Ruckus setups vary with controller type and firmware version. For SmartZone, ZoneDirector or RUCKUS One, or if you're stuck on any step, get in touch:
- Email: hello@captifi.io
- Live Chat: Available on captifi.io
- Ruckus Documentation: Ruckus Support