Set up RUCKUS SmartZone with MyWiFi

What you'll need

• Admin access to your SmartZone controller (vSZ-E, vSZ-H, SZ100, SZ144, SZ300) or a RUCKUS One cloud account with admin rights
• SSH access to the controller, if you're on an on-premises SmartZone (not needed for RUCKUS One cloud)
• Firewall access to open the controller's Northbound Interface port to MyWiFi's servers, if you're on-premises
• The Location (one physical venue in MyWiFi, with its own devices, campaigns, and guest data) already created in your MyWiFi dashboard

Steps

1. In the SmartZone admin UI, go to System > General Settings > Northbound Interface. Turn it on and set a strong password. This is a separate password from your admin login — it's used only for this integration, so keep it handy, you'll enter it again in MyWiFi.
2. Create a Hotspot (WISPr — one of the standard protocols WiFi hardware uses to ask MyWiFi whether a guest may go online) portal profile and set "Redirect unauthenticated user" to your MyWiFi splash page (the branded login page guests see) URL for this location.
3. Create or edit your guest WLAN: set its authentication type to Hotspot (WISPr) and attach the portal profile from step 2.
4. Add MyWiFi's domains to the Walled Garden (the short list of domains guests can reach before logging in) on that WLAN so guests can reach the splash page before they've logged in.
5. If you're on an on-premises controller, SSH in as a superuser and run no encrypt-mac-ip. Skipping this is the single most common reason this integration fails — without it, the controller sends your guests' device info encrypted and MyWiFi can't read it. RUCKUS One cloud controllers don't need this step.
6. In the MyWiFi dashboard, go to Devices and click Add Device.
7. Select the Location, name the device, and under Select Your Hardware choose RUCKUS SmartZone.
8. Enter your RUCKUS connection details as prompted — username, password, controller URL, zone ID, and WLAN ID — and save. (RUCKUS One cloud accounts use different credentials — follow the on-screen field labels at this step.)

Best practice: On-premises controllers need inbound access from MyWiFi — the Northbound Interface port (9080 for HTTP, 9443 for HTTPS) has to be open on your firewall to MyWiFi's servers. If guests can never get past the splash page after everything above is configured, check this first.

Related articles

• Set up RUCKUS Unleashed / ZoneDirector with MyWiFi
• Set up Cambium cnMaestro with MyWiFi