Unifi hotspot
Author: i | 2025-04-24
UniFi Hotspot System. Back to Top. Intended as a separate guest management platform, the UniFi Hotspot System comes freely integrated into the UniFi Controller software. UniFi Controller admins and hotspot operators can access the Hotspot System via the GO TO HOTSPOT MANAGER link in Settings Guest Control Hotspot section. Users will be
UniFi Hotspot: WiFi Hotspot UniFi AP [
3Configure with Name, Bandwidth Limit (Download), Bandwidth Limit (Upload)Step 4Upon completion of the above steps, click the Apply Changes to save. Downloading the Configuration FilesStep 1From the context menu of the gateway, press Download Gateway Config Files to download the configuration zip file. Step 2Once the zip file is unpacked, you will find the following files:authorize.htmlindex.htmlStep 3The files must be edited in the Ubiquiti Themes folder. The paths vary depending on the SO where the Ubiquiti Controller is installed:Windows: C:\Users\\Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portalMAC: ~/Library/Application Support/UniFi/data/sites/default/app-unifi-hotspot-portalLinux: /usr/lib/unifi/data/sites/default/app-unifi-hotspot-portalFor some Linux installations path will be: /opt/unifi/data/sites/default/app-unifi-hotspot-portalCloudKey: /srv/unifi/data/sites/default/app-unifi-hotspot-portal you don’t need to edit the MAC address of the gateway in your &DEVICE%.Step 4In your firewall, configure the port forward to accept disconnection requests from your HSNM (the same as in the “Radius Authentication and Access Control” paragraph and prerequisites).You need to create the rule must with the following characteristics:enable itlimit it to the public IP of your HSNM (optional but we suggest it for security reasons)the port must be the same set up in the “Guest Hotspot” paragraph and chosen in the prerequisitesaddress it to the LAN IP address of the UniFi controllerselect the UDP protocol Step 6For Ubiquiti-type gateways, you need to enable these settings for the reasons listed below:Force disconnections: if enabled, connections that have not received updates from the gateway for the ‘Interim Update’ time defined in the Product Policy plus the Timeout for Idle’ value are automatically closed. Send disconnections requests to the gateway: in addition to forcing disconnections, it also sends a radius disconnection request to the gateway. Some types of gateways (e.g. Ubiquiti) may not send the stop to the radius and consider the device always active. If enabled, the gateway has to be reachable for the UDP port indicated in the “Guest Hotspot” paragraph.Port for disconnection requests: port used by the gateway to accept disconnection requests. It is usually the 3799 but can vary depending on the type of gateway. It is the same one configured in the “Guest Hotspot” paragraph and opened in the firewall at the beginning of Step 5 in the “Downloading the Configuration Files” paragraph.Check consumption by users: If the gateway does not support all the necessary radius attributes and the appliance is able to send disconnection requests (points listed above), it periodically checks the consumption of the logged-in users and if time/traffic limits are reached or at expiration, disconnects the user.Configuring the NetworkStep 1From UniFi Hotspot System. Back to Top. Intended as a separate guest management platform, the UniFi Hotspot System comes freely integrated into the UniFi Controller software. UniFi Controller admins and hotspot operators can access the Hotspot System via the GO TO HOTSPOT MANAGER link in Settings Guest Control Hotspot section. Users will be By default. When disabled, guests can access the Internet without entering a password or accepting the terms of service. When this option is enabled, you can control the Guest Portal. Page 34 Chapter 3: Using the UniFi Controller Software UniFi Controller User Guide Landing Page After connecting, guests are redirected to Expiration Specify the guest login expiration after a the landing page. Select one of the following options: designated period of time: 8 hours, 24 hours, 2 days, 3 days, 4 days, 7 days, or User‑defined, which can be designated in... Page 35 JSP (Java Server Pages). Text position Select the appropriate location for the The UniFi Controller offers a built-in editor to customize welcome text, Under the logo or Above boxes. AngularJS; however, it is not fully customizable at this time. Page 36 Chapter 3: Using the UniFi Controller Software UniFi Controller User Guide • Terms of Service Select Enable terms of service to add • Desktop Preview Enabled by default. The Desktop any terms of service you want hotspot users to accept. Page 37 UniFi Controller User Guide Chapter 3: Using the UniFi Controller Software Select the Voucher and/or Payment method of Hours Enter the number of access hours the package authorization: allows. Vouchers Limit Download • Use Hotspot Manager to create vouchers Enter the maximum download (including distributable code, duration values, and use bandwidth in Kbps. Page 38 Chapter 3: Using the UniFi Controller Software UniFi Controller User Guide • Gateway (Available only for payment-based authentication.) You have multiple options: PayPal Website Payment Pro (US, Canada, ™ Use your PayPal Website Payments Pro account. To manage payments and transactions, click , and see “Hotspot Manager”... Page 39 UniFi Controller User Guide Chapter 3: Using the UniFi Controller Software • Hotspot Operator Click Go to Hotspot Manager Authentication > External Portal Server to manage Wireless Guests, Payments/Transactions, Select this option if you are using an external server to Vouchers, and Operator Accounts. Page 40 The super admin account is created during the Setup who issued the invitation can select which role the Wizard and has global admin (read/write) access; this new administrator will have with respect to the UniFi super admin account cannot be revoked or re-invited. Controller. Page 41 The default inform port is 8080. (You can customize this in system.properties.) Network Discovery When enabled, this option allows UniFi to be discoverable via UPnP on the Layer-2Comments
3Configure with Name, Bandwidth Limit (Download), Bandwidth Limit (Upload)Step 4Upon completion of the above steps, click the Apply Changes to save. Downloading the Configuration FilesStep 1From the context menu of the gateway, press Download Gateway Config Files to download the configuration zip file. Step 2Once the zip file is unpacked, you will find the following files:authorize.htmlindex.htmlStep 3The files must be edited in the Ubiquiti Themes folder. The paths vary depending on the SO where the Ubiquiti Controller is installed:Windows: C:\Users\\Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portalMAC: ~/Library/Application Support/UniFi/data/sites/default/app-unifi-hotspot-portalLinux: /usr/lib/unifi/data/sites/default/app-unifi-hotspot-portalFor some Linux installations path will be: /opt/unifi/data/sites/default/app-unifi-hotspot-portalCloudKey: /srv/unifi/data/sites/default/app-unifi-hotspot-portal you don’t need to edit the MAC address of the gateway in your &DEVICE%.Step 4In your firewall, configure the port forward to accept disconnection requests from your HSNM (the same as in the “Radius Authentication and Access Control” paragraph and prerequisites).You need to create the rule must with the following characteristics:enable itlimit it to the public IP of your HSNM (optional but we suggest it for security reasons)the port must be the same set up in the “Guest Hotspot” paragraph and chosen in the prerequisitesaddress it to the LAN IP address of the UniFi controllerselect the UDP protocol Step 6For Ubiquiti-type gateways, you need to enable these settings for the reasons listed below:Force disconnections: if enabled, connections that have not received updates from the gateway for the ‘Interim Update’ time defined in the Product Policy plus the Timeout for Idle’ value are automatically closed. Send disconnections requests to the gateway: in addition to forcing disconnections, it also sends a radius disconnection request to the gateway. Some types of gateways (e.g. Ubiquiti) may not send the stop to the radius and consider the device always active. If enabled, the gateway has to be reachable for the UDP port indicated in the “Guest Hotspot” paragraph.Port for disconnection requests: port used by the gateway to accept disconnection requests. It is usually the 3799 but can vary depending on the type of gateway. It is the same one configured in the “Guest Hotspot” paragraph and opened in the firewall at the beginning of Step 5 in the “Downloading the Configuration Files” paragraph.Check consumption by users: If the gateway does not support all the necessary radius attributes and the appliance is able to send disconnection requests (points listed above), it periodically checks the consumption of the logged-in users and if time/traffic limits are reached or at expiration, disconnects the user.Configuring the NetworkStep 1From
2025-03-30By default. When disabled, guests can access the Internet without entering a password or accepting the terms of service. When this option is enabled, you can control the Guest Portal. Page 34 Chapter 3: Using the UniFi Controller Software UniFi Controller User Guide Landing Page After connecting, guests are redirected to Expiration Specify the guest login expiration after a the landing page. Select one of the following options: designated period of time: 8 hours, 24 hours, 2 days, 3 days, 4 days, 7 days, or User‑defined, which can be designated in... Page 35 JSP (Java Server Pages). Text position Select the appropriate location for the The UniFi Controller offers a built-in editor to customize welcome text, Under the logo or Above boxes. AngularJS; however, it is not fully customizable at this time. Page 36 Chapter 3: Using the UniFi Controller Software UniFi Controller User Guide • Terms of Service Select Enable terms of service to add • Desktop Preview Enabled by default. The Desktop any terms of service you want hotspot users to accept. Page 37 UniFi Controller User Guide Chapter 3: Using the UniFi Controller Software Select the Voucher and/or Payment method of Hours Enter the number of access hours the package authorization: allows. Vouchers Limit Download • Use Hotspot Manager to create vouchers Enter the maximum download (including distributable code, duration values, and use bandwidth in Kbps. Page 38 Chapter 3: Using the UniFi Controller Software UniFi Controller User Guide • Gateway (Available only for payment-based authentication.) You have multiple options: PayPal Website Payment Pro (US, Canada, ™ Use your PayPal Website Payments Pro account. To manage payments and transactions, click , and see “Hotspot Manager”... Page 39 UniFi Controller User Guide Chapter 3: Using the UniFi Controller Software • Hotspot Operator Click Go to Hotspot Manager Authentication > External Portal Server to manage Wireless Guests, Payments/Transactions, Select this option if you are using an external server to Vouchers, and Operator Accounts. Page 40 The super admin account is created during the Setup who issued the invitation can select which role the Wizard and has global admin (read/write) access; this new administrator will have with respect to the UniFi super admin account cannot be revoked or re-invited. Controller. Page 41 The default inform port is 8080. (You can customize this in system.properties.) Network Discovery When enabled, this option allows UniFi to be discoverable via UPnP on the Layer-2
2025-04-14By the client. page 34 for more information). The default User Group Port Displays the name and port of the UniFi device is Automatic. being used by the client. You can click the name to get Save Click Save to apply changes. Page 118: Wired Client - History Chapter 14: Client Details UniFi Controller User Guide Deep Packet Inspection Wired Client – Configuration The Deep Packet Inspection information is available if the Config DPI feature is enabled (refer to “Settings > Site” on page 20 for more information). Page 119: Chapter 15: Hotspot Manager URL, which should be in this format: The Hotspot Manager includes four main tabs when accessed by the UniFi Controller super admin account. For details on a specific tab, refer to the appropriate section. Guests Guests The Hotspot’s active guests are displayed. Page 120: Payments And Transactions Chapter 15: Hotspot Manager UniFi Controller User Guide Package Displays the description of the package that was Status Displays the status of the transaction. purchased (if applicable). Actions Click a button to perform the desired action: Amount Displays the amount paid for access (if •... Page 121: Operator Accounts Displays Expired if the voucher is no The UniFi Hotspot Manager login screen will appear. Enter longer valid. Displays the number of times used and time the username and password in the appropriate fields and until expiration for multi-use vouchers. Page 122 Chapter 15: Hotspot Manager UniFi Controller User Guide Ubiquiti Networks, Inc. Page 123: Appendix A: Portal Customization With Legacy Jsp Legacy JSP 1. Go to Settings and click Guest Control. Before You Begin Starting with UniFi v5, you have two options for portal customization: AngularJS and Legacy JSP. AngularJS AngularJS is the new option for client-side rendering. We recommend AngularJS unless you are using old templates. Page 124: Viewing The Default Portal Right-click the Network icon. 2. Select the Guest Network SSID and click Connect. 2. Control-click the UniFi application and then click Show Package Contents. 3. Depending on the security type applied to the network, enter the security key or password. Click OK or Connect. Page 125 UniFi Controller User Guide Appendix A: Portal Customization with Legacy JSP 5. Double-click the data folder to open it. 9. You have several files that you can customize in the portal folder (these are described in the Customizable Default Files section). Page 126 Appendix A: Portal Customization with Legacy JSP
2025-04-21