Purple on Ubiquiti UniFi: guest portal, PPSK and staff WiFi
The UniFi Network Application supports an external guest portal with allowed authorisation subnets (the walled garden), RADIUS profiles for staff and Private PSK (PPSK) VLANs. Purple fills each role, so a UniFi estate gets branded guest sign-in and per-user access without changing hardware.
What Purple supports on Ubiquiti UniFi
Four capabilities are supported on Ubiquiti UniFi, the same four we list for it in the hardware integrations directory. Each one uses settings the UniFi Network Application already has, so nothing new is installed on site.
Guest captive portal
The UniFi Network Application redirects guests on your guest SSID to a Purple splash page, where they sign in by email, social login or SMS. Every sign-in becomes a consented first-party record you can report on and market to.
802.1X staff WiFi
Add Purple as the RADIUS server for your staff SSID and each person signs in with their own credentials rather than a shared password, so a leaver loses access the moment their account is removed.
Multi-tenant WiFi: UniFi PPSK (Private PSK)
Each resident, tenant or device group gets a personal key on one shared SSID. Purple manages the keys and the UniFi Network Application enforces them.
Dynamic VLAN steering
Purple returns a VLAN with each RADIUS decision, so a user or key lands on the right network segment without an SSID per group.
Supported Ubiquiti UniFi platforms
UniFi APs (U6-Pro, U7-Pro, U6-Enterprise), UniFi Cloud Key, Dream Machine (UDM-Pro), UniFi Network Controller
RADIUS servers, ports and the walled garden allowlist are maintained by our support team and can differ per deployment. Get the current Ubiquiti UniFi configuration from Purple Support.
How to set up Purple on Ubiquiti UniFi
A guest WiFi rollout on Ubiquiti UniFi follows the same five steps whatever the size of the estate. The step-by-step guides linked here cover the exact UniFi Network Application screens.
Check your platform is on the supported list
Purple supports UniFi APs (U6-Pro, U7-Pro, U6-Enterprise), UniFi Cloud Key, Dream Machine (UDM-Pro), UniFi Network Controller. If your controller or firmware is not listed, ask us before you start.
Point the guest SSID at Purple in the UniFi Network Application
Set the guest network's captive portal or splash page to Purple's hosted portal and add Purple as its RADIUS server. The Ubiquiti UniFi setup guide walks through each screen.
Add the walled garden and RADIUS details from Purple Support
The walled garden entries and RADIUS servers are set per deployment and change over time, so take them from the hardware guide on support.purple.ai, not from a summary page.
Build your splash page and choose sign-in methods
Design the splash page in Purple, pick the login methods and data fields you need, and set consent wording for your region.
Test on real devices, then roll out
Connect with an iPhone, an Android phone and a laptop before you open the network to guests. If the portal does not appear, the troubleshooting guides below cover the usual causes.
Start with these Ubiquiti UniFi guides
Every Ubiquiti UniFi guide, by task
11 published guides name Ubiquiti UniFi in their title or cover it in depth. This list updates as new guides are published.
Captive portal and splash page setup (5)
- Android 上的 Captive Portal 登录：Cisco Meraki、HPE Aruba 和 Ubiquiti UniFi 的部署清单
使用此清单，让 Android 登录通知在 Cisco Meraki、HPE Aruba 和 Ubiquiti UniFi 上稳定可靠地显示。您将划定一个严格的围墙花园、在登录前拦截流量、使用 HTTPS 保护登录页面并保持 DNS 正常工作。您还将选择会话超时时间、决定 DHCP option 114 并追溯每个访客症状以进行修复。
- Ubiquiti UniFi 和访客 WiFi：配合 Purple 的 Captive Portal 设置
Ubiquiti UniFi Network 如何与 Purple 访客 WiFi 协同工作：外部门户服务器、控制器授权和围墙花园，并附有指向 Purple 逐步设置指南的链接以进行精确配置。
- Ubiquiti UniFi 的 Captive Portal：使用 Purple 访客 WiFi 进行设置
如何为 Ubiquiti UniFi 添加 Purple Captive Portal：外部门户服务器、控制器授权和围墙花园，并附有 Purple 逐步设置指南的链接以进行精确配置。
- TP-Link Omada 与 Purple WiFi：中小企业部署方案
本权威指南为 IT 经理和网络架构师提供了将 TP-Link Omada 接入点与 Purple 云端 RADIUS 基础设施集成的明确蓝图。它涵盖了架构设计、逐步 Captive Portal 配置、Walled Garden 要求，以及与 UniFi 在中小企业部署中的商业比较。
- 在企业网络控制器上配置 Captive Portal 重定向
本权威指南详细介绍了在企业网络控制器上实施 Captive Portal 重定向所需的技术架构和特定于供应商的配置步骤。它为 IT 团队在配置 Walled Garden、集成 RADIUS 身份验证以及确保符合 GDPR 和 PCI DSS 规范方面提供了可操作的指导。
802.1X, RADIUS and network access control (1)
- 如何在常见接入点平台（Cisco、Aruba、Ubiquiti）上配置WPA2-Enterprise
本技术参考指南为资深IT专业人员和网络架构师提供了在Cisco、Aruba和Ubiquiti平台上部署WPA2-Enterprise的权威、针对特定供应商的演练。它详细介绍了架构、RADIUS集成、合规要求以及跨企业和场馆环境的实际部署场景。
iPSK, PPSK and per-device keys (3)
- 各厂商每设备 PSK：iPSK、DPSK、MPSK 和 PPSK 比较（以及 WPA3 支持）
全面比较 Cisco Meraki、HPE Aruba、Ruckus、Juniper Mist、Extreme、Fortinet 和 Ubiquiti UniFi 的每设备 PSK 实现。了解 WPA3-SAE 如何影响每设备密钥策略，以及何时部署过渡模式或转向 802.1X。
- 如何利用每设备 PSK (iPSK, DPSK, MPSK) 减少 WiFi SSID 的数量
本权威技术参考指南介绍了 IT 团队如何通过使用每设备 PSK (xPSK) 将多个专用网络合并为一个单一 SSID，从而消除由 SSID 信标开销引起的 WiFi 性能下降。它涵盖了 Cisco iPSK、HPE Aruba MPSK、Ruckus DPSK、Juniper Mist PPSK 和 Ubiquiti UniFi…
- 如何在 Cisco Meraki、HPE Aruba 和 Ruckus 上部署 iPSK
本实用参考指南演示了如何在 Cisco Meraki 上部署 iPSK、在 HPE Aruba Central 上部署 MPSK 以及在 Ruckus SmartZone 上部署 DPSK，并附带简短的 UniFi PPSK 附录。重点介绍密钥分发、VLAN 或策略分配、RADIUS 决策流以及证明部署在实际场所中正常工作的撤销测试。
Troubleshooting (1)
- Ubiquiti UniFi 访客门户未重定向：原因与解决方法
本指南通过依次分析访客状态、重定向、预授权路由和控制器授权，解决 UniFi 访客门户重定向失败的问题。它为场所 IT 团队提供了一种行之有效的方法，用以解决访客网络与 Hotspot 混淆、外部门户交接、当前 UniFi OS 帐户要求以及 DNS 隔离测试等问题。
Architecture, comparisons and planning (1)
- 选择企业级接入点：Cisco、Aruba、Ruckus 与 UniFi 深度对比
对比 Cisco Meraki、Aruba、Ruckus 和 UniFi 企业级接入点。评估 WiFi 6E/7、TCO 许可、RF 射频性能和控制器架构。
What you can run on Ubiquiti UniFi
The integration is the entry point. These are the Purple products that run on top of it, each on the Ubiquiti UniFi hardware you already have.
Running more than one vendor?
Purple is one platform across mixed estates. The other hardware hubs cover the same four capabilities:
- Cisco Catalyst and AireOS
- Cisco Meraki
- HPE Aruba
- Ruckus
- Fortinet
- Juniper Mist
- Extreme Networks
- TP-Link Omada
Comparing Purple with another guest WiFi or RADIUS platform instead? See every Purple comparison or captive portal software compared.
Ubiquiti UniFi and Purple: questions
Does Purple work with Ubiquiti UniFi?
Yes. On Ubiquiti UniFi, Purple provides the guest captive portal, cloud RADIUS for 802.1X staff WiFi, UniFi PPSK (Private PSK) for multi-tenant WiFi and dynamic VLAN steering. Supported platforms: UniFi APs (U6-Pro, U7-Pro, U6-Enterprise), UniFi Cloud Key, Dream Machine (UDM-Pro), UniFi Network Controller.
Do I need to replace my Ubiquiti UniFi access points to use Purple?
No. Purple runs on the access points you already own. You configure the guest SSID in the UniFi Network Application to redirect to Purple's hosted splash page and add Purple as a RADIUS server; the hardware stays as it is.
Where do I find the RADIUS servers and walled garden entries for Ubiquiti UniFi?
In the hardware guides on support.purple.ai. Those values are set per deployment and change over time, so we do not publish them on marketing pages or in guides. Always take them from Purple Support.
How does multi-tenant WiFi work on Ubiquiti UniFi?
With UniFi PPSK (Private PSK). Each resident, tenant or device group gets its own key on a shared SSID, and Purple returns the matching VLAN over RADIUS, so each unit gets a private network without an SSID per unit.
Which Ubiquiti UniFi guide should I read first?
Start with "Ubiquiti UniFi and Purple WiFi integration guide". It covers the UniFi Network Application settings for the guest portal. The rest of the Ubiquiti UniFi guides on this page are grouped by task: portal setup, 802.1X and RADIUS, per-user keys and troubleshooting.
Can I run Purple across Ubiquiti UniFi and other hardware?
Yes. Purple is one platform across mixed estates, so sites on different vendors share the same splash pages, sign-in data, reporting and RADIUS policies. The hardware integrations directory lists every supported vendor.
See Purple on your Ubiquiti UniFi network
Tell us what you run today and we will show you the guest, staff and multi-tenant setup on your own hardware.