Skip to main content

Technical WiFi guides

Deep, expert-led technical guides on guest WiFi, analytics, captive portals, and venue technology.

Ready to move from research to rollout? See how Purple's captive portal software handles branded guest sign-in, analytics, and compliance in one platform.

Ubiquiti UniFi guest portal not redirecting: causes and fixes
Captive Portals

Ubiquiti UniFi guest portal not redirecting: causes and fixes

This guide isolates a UniFi guest portal redirect failure by following the guest state, redirect, pre-authorization route and controller authorization in sequence. It gives venue IT teams a sourced method to address guest-network versus Hotspot confusion, external portal hand-offs, current UniFi OS account requirements and DNS isolation testing.

12 mins read3k words
Cisco Meraki splash page not working: a troubleshooting flowchart
Captive Portals

Cisco Meraki splash page not working: a troubleshooting flowchart

This practical day-two guide isolates where a Cisco Meraki splash flow has failed: client authorization, HTTP redirect initiation, walled-garden reachability or RADIUS sign-on. It gives venue IT teams a controlled evidence path, so they can restore Guest WiFi without making broad changes to a live estate.

12 mins read3k words
Enterprise Guest WiFi Setup Guide: VLAN Segmentation, Security, and Captive Portals
Captive Portals

Enterprise Guest WiFi Setup Guide: VLAN Segmentation, Security, and Captive Portals

This technical guide shows IT teams how to set up Guest WiFi as a controlled internet-access service, using VLAN segmentation, firewall policy, and a captive portal. It also explains how Purple's registration forms and onboarding controls support a proportionate visitor experience without weakening the boundary around staff, payment, and operational systems.

12 mins read3k words
How to Set Up a Captive Portal on Starlink: A Guide for Maritime, Transportation, and Remote Sites
Captive Portals

How to Set Up a Captive Portal on Starlink: A Guide for Maritime, Transportation, and Remote Sites

This technical guide explains how to bypass Starlink's native CGNAT limitations to deploy a secure, CCPA/CPRA-compliant captive portal for guest WiFi. It covers network architecture, VLAN segmentation, and cloud RADIUS integration for maritime, transportation, and remote enterprise sites.

5 mins read1k words
How to Set Up a Captive Portal on Starlink for Guest WiFi
Captive Portals

How to Set Up a Captive Portal on Starlink for Guest WiFi

This technical guide explains how to bypass Starlink's native CGNAT limitations to deploy a secure, CCPA/CPRA-compliant captive portal for guest WiFi. It covers the required architecture, VLAN segmentation, and bandwidth management strategies essential for remote venues, maritime operators, and event spaces.

4 mins read1k words
Captive portal for Ruijie: set it up with Purple guest WiFi
Captive Portals

Captive portal for Ruijie: set it up with Purple guest WiFi

How Purple's cloud guest WiFi sits on top of Ruijie RG Series access points using web authentication and RADIUS, configured from the command line, and where to find the exact setup steps.

2 mins read0k words
Designing B2B Captive Portals: Collecting Registered Name and Company Data
Captive Portals

Designing B2B Captive Portals: Collecting Registered Name and Company Data

This guide provides IT managers and venue operators with a vendor-neutral technical framework for designing B2B captive portals. It details how to structure registration fields to capture registered name and company data, ensuring high completion rates while maintaining CCPA/CPRA compliance and building account-level intelligence.

5 mins read1k words
Captive Portal Architecture: Security, Redirection, and Best Practices
Captive Portals

Captive Portal Architecture: Security, Redirection, and Best Practices

A definitive technical reference on enterprise captive portal architecture. This guide unpacks network isolation, DNS redirection, RADIUS authentication, and security compliance for IT leaders deploying secure, data-rich guest WiFi networks.

5 mins read1k words
Optimizing B2B Captive Portals: Capturing Company Names and Professional Data
Captive Portals

Optimizing B2B Captive Portals: Capturing Company Names and Professional Data

This guide explains how IT managers, network architects, and venue operations directors can configure B2B captive portals to capture professional data - company names, job titles, and business email addresses - at the point of WiFi login. It covers the full technical architecture from VLAN isolation and RADIUS authentication through to CRM integration with Salesforce and HubSpot, with CCPA/CPRA compliance built in. Venues that deploy this correctly turn their guest WiFi network into a first-party data engine and automated lead generation system.

8 mins read2k words
How to Set Up a Captive Portal on Starlink: A Guide for Remote & Maritime Venues
Captive Portals

How to Set Up a Captive Portal on Starlink: A Guide for Remote & Maritime Venues

This guide details how to bypass the native Starlink hardware and integrate a cloud-managed captive portal using enterprise routing equipment. You will learn how to overcome the CGNAT limitation, enforce VLAN segmentation, manage satellite bandwidth constraints, and ensure regulatory compliance.

5 mins read1k words
Captive Portal Best Practices: Designing for High Conversion and Compliance
Captive Portals

Captive Portal Best Practices: Designing for High Conversion and Compliance

This technical guide gives IT managers, network architects, and venue operations directors a complete blueprint for deploying captive portals that balance network security with high user conversion. It covers the full architecture from VLAN segmentation and RADIUS authentication to CCPA/CPRA-compliant consent design and authentication method selection. Drawn from Purple's operational experience across 80,000+ venues and 440 million logins in 2024, every recommendation is grounded in real deployment data.

8 mins read2k words
How to Optimize Captive Portals for Maximum Network Security and User Conversion
Captive Portals

How to Optimize Captive Portals for Maximum Network Security and User Conversion

This guide provides a complete technical blueprint for optimizing captive portals across enterprise venues, covering network segmentation architecture, authentication method selection, CCPA/CPRA-compliant consent design, and conversion optimization. It is written for IT managers, network architects, and CTOs at hotels, retail chains, stadiums, and public-sector organizations who need to balance network security with first-party data capture. Purple operates captive portal infrastructure across 80,000+ venues with 440 million logins in 2024, and the frameworks here reflect that operational experience.

10 mins read2k words
Hotel Guest WiFi Architecture: PMS Integration, Captive Portals, and Bandwidth Control
Captive Portals

Hotel Guest WiFi Architecture: PMS Integration, Captive Portals, and Bandwidth Control

This guide provides a comprehensive framework for architecting enterprise-grade hotel WiFi networks. It details the technical requirements for VLAN segmentation, PMS integration via FIAS, captive portal design, and per-client bandwidth control to ensure security, compliance, and optimal performance.

6 mins read1k words
Why is my guest WiFi not connecting? Troubleshooting captive portal issues
Captive Portals

Why is my guest WiFi not connecting? Troubleshooting captive portal issues

This authoritative technical reference guide explains the underlying mechanics of captive portal detection and details the six primary failure modes that prevent guest WiFi from connecting. It provides IT managers and network architects with a practical troubleshooting framework to resolve HTTP redirect issues, DNS conflicts, and MAC randomization challenges.

6 mins read1k words
Integrating WeChat Authentication with Guest WiFi Captive Portals
Captive Portals

Integrating WeChat Authentication with Guest WiFi Captive Portals

This guide explains how to integrate WeChat OAuth 2.0 authentication into enterprise guest WiFi captive portals. It covers the dual-platform registration requirements, scope selection for first-party data capture, network enforcement via RADIUS Change of Authorization, and compliance with CCPA/CPRA and China's PIPL. Venue operators in hospitality, retail, and events will find concrete implementation steps, real-world case studies, and security hardening guidance to deploy WeChat login guest WiFi at scale.

8 mins read2k words
Integrating WeChat WiFi Authentication: Captive Portal Onboarding for APAC Customers
Captive Portals

Integrating WeChat WiFi Authentication: Captive Portal Onboarding for APAC Customers

WeChat has 1.41 billion monthly active users, making it the primary digital identity for Chinese consumers globally. This guide explains how to integrate WeChat OAuth 2.0 authentication into enterprise captive portals for APAC venues, covering platform registration, scope selection, RADIUS Change of Authorisation enforcement, and dual-framework compliance with GDPR and China's PIPL. It is aimed at IT managers, network architects, and venue operations directors who need to act this quarter.

9 mins read2k words
Configuring Captive Portal Redirection on Enterprise Network Controllers
Captive Portals

Configuring Captive Portal Redirection on Enterprise Network Controllers

This authoritative guide details the technical architecture and vendor-specific configuration steps required to implement captive portal redirection on enterprise network controllers. It provides actionable guidance for IT teams on configuring walled gardens, integrating RADIUS authentication, and ensuring compliance with GDPR and PCI DSS.

6 mins read1k words
Step-by-Step Guide: Configuring Ruijie Wireless Controllers for Guest WiFi Captive Portals
Captive Portals

Step-by-Step Guide: Configuring Ruijie Wireless Controllers for Guest WiFi Captive Portals

This guide provides a complete technical walkthrough for configuring Ruijie wireless controllers and gateways to deploy enterprise-grade guest WiFi captive portals. It covers VLAN segmentation, external RADIUS authentication via WISPr protocol, walled garden configuration, and seamless integration with Purple's Identity-Based Networks platform to capture first-party data and drive measurable business value across hospitality, retail, and public-sector environments.

8 mins read2k words
Staff WiFi Captive Portal: Onboarding and Authenticating Employees
Captive Portals

Staff WiFi Captive Portal: Onboarding and Authenticating Employees

A comprehensive technical reference for IT leaders on designing and deploying staff WiFi captive portals. This guide covers EAP-TLS authentication, BYOD onboarding, VLAN segmentation, and bandwidth management to enhance operational efficiency and mitigate security risks.

6 mins read1k words
Integrating WeChat WiFi Login: Capturing Engagement via Social Captive Portals
Captive Portals

Integrating WeChat WiFi Login: Capturing Engagement via Social Captive Portals

This guide details how to integrate WeChat WiFi authentication into enterprise captive portals, covering the OAuth 2.0 architecture, RADIUS integration, and step-by-step deployment across Cisco Meraki, HPE Aruba, and Juniper Mist hardware. It gives IT managers and network architects a practical framework for capturing first-party data from WeChat's 1.3 billion users while driving engagement via Official Account follows and post-login redirects.

8 mins read2k words
WiFi CCPA/CPRA Compliance: How to Securely Collect Guest Data via Captive Portals
Captive Portals

WiFi CCPA/CPRA Compliance: How to Securely Collect Guest Data via Captive Portals

This technical guide gives IT managers, network architects, and venue operations directors a practical framework for achieving CCPA/CPRA compliance across guest WiFi deployments. It covers how captive portals collect personal data, how to secure explicit consent, and how to implement automated data retention policies that protect your organization from regulatory fines and statutory damages. Purple's guest WiFi platform maps directly to each compliance requirement, from consent logging to one-click data erasure.

8 mins read2k words
How to Configure WeChat OAuth Authentication for Captive Portals
Captive Portals

How to Configure WeChat OAuth Authentication for Captive Portals

This technical guide explains how to configure WeChat OAuth authentication for captive portals. It details the required platform registrations, OAuth 2.0 flow, scope selection, and network enforcement mechanisms necessary to capture first-party data from Chinese visitors securely.

4 mins read1k words
Why your captive portal is not loading on iPhone: Fix Apple CNA errors
Captive Portals

Why your captive portal is not loading on iPhone: Fix Apple CNA errors

Troubleshoot and fix captive portal popup failures on iPhone and iOS. Learn how Apple CNA, iCloud Private Relay, and MAC randomization break WiFi logins, and how to fix them.

10 mins read2k words
Custom Captive Portal: HTML and CSS Guide
Captive Portals

Custom Captive Portal: HTML and CSS Guide

This authoritative technical reference guide outlines the development standards, CSS architecture, and network-level constraints required to design and code a custom captive portal landing page. It provides frontend developers and network architects with actionable strategies to navigate Apple CNA and Android webview environments, ensuring pixel-perfect, compliant, and highly performant guest WiFi experiences.

11 mins read3k words