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
15 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 上穩定顯示。您將規劃嚴格的 walled garden、在登入前封鎖流量、使用 HTTPS 保護登入頁面並保持 DNS 正常運作。您還將選擇工作階段逾時時間、決定 DHCP option…
- Ubiquiti UniFi 的 Captive Portal：搭配 Purple 訪客 WiFi 進行設定
如何為 Ubiquiti UniFi 新增 Purple Captive Portal：包含外部入口網站伺服器、控制器授權和 Walled Garden，並附有指向 Purple 逐步設定指南的連結以進行精確配置。
- Ubiquiti UniFi 與顧客 WiFi：使用 Purple 進行 Captive Portal 設定
Ubiquiti UniFi Network 如何與 Purple 顧客 WiFi 搭配運作：外部入口網站伺服器、控制器授權和圍牆花園（Walled Garden），並附有 Purple 的逐步設定指南連結，以進行精確配置。
- 在企業網路控制器上設定 Captive Portal 重新導向
本權威指南詳細介紹了在企業網路控制器上實作 captive portal 重新導向所需的技術架構和特定廠商設定步驟。它為 IT 團隊在設定 walled gardens、整合 RADIUS 驗證以及確保符合 GDPR 和 PCI DSS 規範方面提供了具體可行的指導。
- 適用於中小企業部署的 TP-Link Omada 與 Purple WiFi
本權威指南為 IT 經理和網路架構師提供了將 TP-Link Omada 存取點與 Purple 的雲端 RADIUS 基礎架構相整合的決定性藍圖。內容涵蓋架構設計、逐步 Captive Portal 設定、Walled Garden 需求，以及與 UniFi 針對中小企業部署的商業效益比較。
802.1X, RADIUS and network access control (2)
- 如何在常見的存取點平台（Cisco、Aruba、Ubiquiti）上設定 WPA2-Enterprise
本技術參考指南為資深 IT 專業人員和網路架構師提供在 Cisco、Aruba 和 Ubiquiti 平台上部署 WPA2-Enterprise 的權威且針對特定廠商的逐步說明。內容詳細介紹了企業和場域環境中的架構、RADIUS 整合、合規性要求以及實際部署情境。
- Intune WiFi 設定檔伺服器信任：Entra ID 憑證伺服器名稱與根 CA 檢查清單
您將能夠設定 Intune WiFi 設定檔的伺服器驗證端，讓 EAP-TLS 與 PEAP 在 Windows、Apple 和 Android 上順利連線。您將學會如何將憑證伺服器名稱與 RADIUS 憑證進行比對、部署正確的根 CA、調整 Entra ID 群組指派，並在憑證更新前進行預排，以免其在背後無預警中斷連線。
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。
- 如何使用單一裝置預共用金鑰（iPSK、DPSK、MPSK）減少 WiFi SSID 數量
本權威技術指南介紹 IT 團隊如何透過單一裝置預共用金鑰（xPSK）將多個特定用途的網路合併為單個 SSID，從而消除由 SSID 訊標開銷引起的 WiFi 效能降低。本指南涵蓋各大廠商的解決方案，包括 Cisco iPSK、HPE Aruba MPSK、Ruckus DPSK、Juniper Mist PPSK 與 Ubiquiti…
- 如何在 Cisco Meraki、HPE Aruba 與 Ruckus 上部署 iPSK
本實用參考指南展示了如何在 Cisco Meraki 上部署 iPSK、在 HPE Aruba Central 上部署 MPSK 以及在 Ruckus SmartZone 上部署 DPSK，並附帶簡短的 UniFi PPSK 附錄。內容重點在於金鑰核發、VLAN 或策略配置、RADIUS…
Troubleshooting (3)
- Ubiquiti UniFi captive portal 疑難排解：外部入口網站、熱點與 walled garden 檢查表
使用此檢查表找出您的 Ubiquiti UniFi captive portal 無法運作的原因並予以解決。您將對照症狀與六大原因、執行兩項快速測試，並修正外部入口網站伺服器、預先授權存取、訪客子網路限制、HTTPS 重新導向、控制器可達性或用戶端設定。
- Ubiquiti UniFi 訪客入口網站未重定向：原因與解決方法
本指南循序追蹤訪客狀態、重新導向、預先授權路由及控制器授權，藉此釐清 UniFi guest portal 重新導向失敗的原因。它為場域 IT 團隊提供了一套經過實證的方法，用以解決訪客網路與 Hotspot 之間的混淆、外部 portal 轉接、目前的 UniFi OS 帳戶要求，以及 DNS 隔離測試。
- Android 802.1X and EAP-TLS 疑難排解：Intune 與 Microsoft Entra ID 的部署檢核清單
您將能夠精確找出託管的 Android 手機在員工 SSID 上無法通過 EAP-TLS 驗證的原因，並在 Intune 中進行修正。將每個症狀與四個常見原因進行比對：遺失憑證授權單位 (CA) 或網域、用戶端憑證位於錯誤的設定檔中、RADIUS 伺服器名稱值不符，或是未遞送受信任的根憑證。然後套用可防止重複斷線的推出檢核清單。
Architecture, comparisons and planning (2)
- Ubiquiti UniFi 上的 802.11k 與 802.11r：快速漫遊設定與部署檢查清單
您將能夠決定在每個 SSID 上啟用哪些 UniFi 漫遊設定、其順序，以及如何證明其運作正常。本指南將 Fast Roaming、BSS Transition 和 802.11k 對應到其 IEEE 標準，標記舊版裝置被鎖定無法連線的風險，並提供六步驟檢查表以及針對黏著用戶端的用戶端歷程記錄檢查。
- 選擇企業級基地台：Cisco、Aruba、Ruckus 與 UniFi 的比較
比較 Cisco Meraki、Aruba、Ruckus 和 UniFi 企業級基地台。評估 WiFi 6E/7、總體擁有成本授權、射頻效能和控制器架構。
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.