Configure Ruckus Smartzone with Spotipo

Ruckus SmartZone controllers provide enterprise-grade WiFi management for high-density environments, and integrating Spotipo's captive portal adds powerful guest WiFi capabilities including email capture, social login, and paid access options. This integration uses Ruckus's Hotspot (WISPr) authentication method with RADIUS to manage guest access while maintaining network performance.

This guide walks you through configuring your Ruckus SmartZone controller to work with Spotipo's cloud authentication system. The setup involves creating hotspot portals, configuring RADIUS servers, and setting up walled garden access for seamless guest authentication.

What you'll accomplish:

What you'll need:

Important note: This guide currently uses Spotipo's legacy UI. To access it, visit app.spotipo.com/oldui while some features are being updated.

Each location is represented by a Site. A site can have multiple routers (of the same type)
​
A new site can be created either while creating a new login or by clicking on the switch sites button and adding a new location.
​

Select Ruckus Smartzone under WiFi hardware, provide a name for the location and click on Save.
​

Go to Smartzone tab on the site you just created and click on New.
Provide a name and optional secret and click on Save.
​

Please note down the Radius Secret, NASID and Location Id generated
​

Please login to controller CLI and execute below command
​

Log into the SmartZone controller and go to the WLAN tab. Use the Create button.
​

In the WLAN configuration, provide the required SSID and Select Hotspot(WISPr) as the authentication method.
​

Under the Hotspot Portal tab, use the Create Button to add a new Hotspot Portal
​

Provide a name for your portal
Set the Redirected Mac format to aa:bb:cc:dd:ee:ff
configure the Location ID generated in Spotipo.
Add https://app.spotipo.com/smartzone/guest/ as URL for unauthenticated user ( replace app.spotipo.com with your server FQDN if you are using a Whitelabel domain)*
In Startpage select, redirect to the following URL
And use https://app.spotipo.com/smartzone/postauth/ as the URL_( replace app.spotipo.com with your server FQDN if you are using a Whitelabel domain)_
Add the below domains to the walled garden
​

<FQDN of your smartzone controller or it's IP>
<FQDN of your whitelabel domain if you have>
​

Check the user controller as proxy option and add below authentication server and accounting server IP addresses and generated secret:
​
35.205.248.64
34.77.150.10
​

Now go to Radius options tab.
​
Select the NAS ID as user-defined.
Provide the value generated in Spotipo.
Configure Called STA ID to AP MAC.
​

Now, you can save and test the configuration by connecting a device to the Guest WiFI network created.

Once your configuration is complete and guests can connect to your WiFi network, the Spotipo portal will appear automatically—and you can start capturing WiFi guest data, running marketing campaigns, or offering paid WiFi access through your Ruckus SmartZone network.

Still having trouble with your Ruckus SmartZone configuration? Contact Spotipo support via live chat or email us at [email protected]—we'll help troubleshoot your specific SmartZone controller setup.