Skip to content

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 ​

  1. Create the venue in CaptiFi to get your portal URL and RADIUS values
  2. Add CaptiFi's RADIUS servers in Unleashed, one for authentication and one for accounting
  3. Create the hotspot service that sends guests to your splash page
  4. Create the guest WLAN on that hotspot service
  5. Set the guest WLAN's NAS-ID over SSH, so CaptiFi knows which venue each guest is at
  6. Test with a phone

Step 1: Create the venue in CaptiFi ​

  1. Log in to my.captifi.io
  2. In the set-up wizard, under How do guests connect to WiFi?, choose Ruckus Unleashed and click Continue
  3. Give the controller a name under Controller name, then set up your venue
  4. 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

The set-up wizard Activate your WiFi step for Ruckus Unleashed, with the portal URL, the allowed domains and the RADIUS server block beneath them, the shared secret masked

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_ID

Your 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.

The Connection checks on the Activate your WiFi step for Ruckus: Controller sending RADIUS traffic, Guest device reached the splash page, each Waiting, and Guests completing the splash page waiting on the check above, with a note that Finish setup unlocks when every check is green, Next: My Venues opens, and the Finish setup button greyed out


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)TypeAuth MethodIP AddressPortShared Secret
CaptiFi-AuthRADIUSPAP46.62.168.71812Your shared secret
CaptiFi-AcctRADIUS Accounting46.62.168.71813Your 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: CaptiFi

  • WISPr 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/connected

    Your 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.

  1. Use the IP address you open the Unleashed web interface on (your master access point)

  2. 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.)

  3. At Please login:, enter your Unleashed admin username and password

  4. 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"
  5. 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 included

  6. Once the WLAN has loaded, enter these lines, shown in your dashboard as 2. Set the NAS-ID and save. Otherwise replace YOUR_NAS_IDENTIFIER with the NAS identifier from your dashboard:

    nasid-type user-define YOUR_NAS_IDENTIFIER
    end
    exit
    exit

    After end, Unleashed replies The WLAN service ... has been updated and saved.


Step 6: Test ​

  1. Join the guest WiFi with a phone
  2. The CaptiFi splash page should open by itself. If it doesn't, open a browser and visit any http:// site, for example http://example.com
  3. Complete the form. After a few seconds the phone is online and shows the connected page, then your venue's redirect URL
  4. Check Guest Visits in your CaptiFi dashboard for the new guest

Troubleshooting ​

IssueSolution
Splash page not appearingCheck 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 allCheck the walled garden has app.captifi.io, captifi.io and 46.62.168.7
Guests complete the splash page but never get onlineCheck 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 afterwardsSet 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 pageThe shared secret doesn't match. Copy it again from your CaptiFi dashboard into both AAA servers
No session data in CaptiFiSelect the CaptiFi accounting server on the hotspot service's Authentication tab
HTTPS sites not triggering redirectGuests 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/ruckus with no site_id and add each venue's access points under WiFi Access Points, Add access point. Unleashed sends the access point's MAC as mac, 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:

CaptiFi: Guest WiFi Marketing Platform