Unifi hotspot
Author: h | 2025-04-23
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 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
GitHub - dominik-probst/unifi-hotspot-telegram: UniFi-Hotspot
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-2Manage Unifi with HACS Unifi Hotspot Manager
The WAN interface. Click Details to display the device specifics, LAN/WAN Speed Displays the connection speed in Mbps. Page 85: Unifi Security Gateway - Configuration UniFi Controller User Guide Chapter 10: UniFi Security Gateway Details UniFi Security Gateway – Configuration Click Configuration to configure the alias, WAN settings, port forwarding, Dynamic DNS, and custom upgrade entries. You can also remove the Gateway from management by this UniFi Controller. Page 86 Chapter 10: UniFi Security Gateway Details UniFi Controller User Guide • PPPoE Point-to-Point Protocol over Ethernet (PPPoE) Smart Queues The Smart Queue feature provides is a virtual private and secure connection between two FQ-CODEL (Fair Queuing with Controlled Delay) + HTB systems that enables encapsulated data transport. Page 87 UniFi Controller User Guide Chapter 10: UniFi Security Gateway Details Port Forward Queue Changes Click Queue Changes to line up the changes to take effect. This allows you to make multiple changes to the device and then apply them all at once so that the device doesn’t have to re-provision over and... Page 88 Chapter 10: UniFi Security Gateway Details UniFi Controller User Guide Create or Edit Port Forwarding Entry Dynamic DNS Domain Name System (DNS) translates domain names to IP addresses; Each DNS server on the Internet holds these mappings in its respective DNS database. Dynamic... Page 89 UniFi Controller User Guide Chapter 10: UniFi Security Gateway Details Custom Upgrade For firmware upgrades, the UniFi devices retrieve the latest firmware from the Ubiquiti website. To specify firmware saved in a custom location, select this option. (URL) Enter the location URL of the firmware. Page 90 Chapter 10: UniFi Security Gateway Details UniFi Controller User Guide Ubiquiti Networks, Inc. Page 91: Chapter 11: Unifi Switch Details Details • Name/MAC Address Displays the device name or MAC address of the device. A UniFi Switch hyperlink opens the UniFi Switch’s Details • Restart Click to restart the selected device. window either in the Properties panel or as a separate •... Page 92: Unifi Switch - Details Displays the name of the uplink or downlink device. There are three clickable tabs: • “UniFi Switch – Details” on page 86 • “UniFi Switch – Ports” on page 87 • “UniFi Switch – Configuration” on page 89 UniFi Switch – Details Click Overview to display the device specifics, connection details, and uptime. Page 93: Unifi Switch - Ports UniFi Controller User Guide Chapter 11: UniFi Switch. 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 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 beCampground Hotspot Setup with UniFi –
By 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 JSPHotspot UniFi nanoHD - Wifimag.ro
Network application pre-installed.You will go through the process of configuring the UniFi OS Console on these devices during the initial device setup and configuration and then can launch the Network application and add your UniFi devices.I'm getting a Java-related error during setup, what do I do?The UniFi Network application requires Java, so you'll need to install Java 8 for your specific platform before re-running the installer.The install is not finishing successfully, what could it be?Make sure that all system requirements are met and that all ports used by UniFi are open. If that is all in order, check that the ethernet cables are in good working condition, changing them with others if need be.How do I access the UniFi OS Console configuration page if I don't know my IP?If you haven't set up your console yet, try accessing it by navigating to setup.ui.com or one of the common addresses: localhost:8443 or 192.168.1.1:8443If this doesn't work, you will need to find out the address of your gateway by using commands like ipconfig/ifconfig or device discovery tools like Ubiquiti's WiFiman.I'm getting a "Your connection is not private" security warning when accessing the UniFi OS Console in my browser, should I be concerned?There's nothing to worry about as it's the intended behavior when connecting to your UniFi OS Console locally. Simply proceed to the next page by clicking Advanced > Proceed.How do I upgrade after the initial setup?When a new stable version becomes available, you will receive an upgrade prompt in your dashboard. Click it to upgrade to the latest version. Otherwise go to the UniFi OS Dashboard > System Settings > Updates and check for updates there.What are the UniFi Network application system requirements?For self-hosted software setups, we recommend the following minimum system requirements (make sure to read the Release Notes for more details about a particular version):Operating system:Linux: Ubuntu Desktop / Server 16.04; Debian 9 "Stretch"Windows: Windows 10; Windows Server 2016macOS: Mavericks 10.9, 10.10 Yosemite, 10.11 El Capitan, 10.12 Sierra, 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina.CPU: x86-64 Processor (Intel / AMD x64 Processors)RAM: 2GBNetwork: 100Mbps Wired EthernetHDD: Minimum 10GB free (20GB or more preferred)Java: Java Runtime Environment (JRE) 8Web Browser: Google ChromeMongoDB: version 3.2 or later. Mongo is offered bundled: default is 2.4.14 (for macOS and Windows only).Does the UniFi Network application have to run at all times?Since UniFi devices retain their settings, internet connectivity will work even if the UniFi OS Console is offline.However, the features running directly on the UniFi OS Console will be lost. This includes statistics, reporting, manually applied user groups and the guest hotspot. If you did not set up a WPA security protocol under the guest hotspot's Advanced > Security, then if the Networkufozone/ha-unifi-voucher: UniFi Hotspot Manager
This chapter describes how to configure Ubiquiti (with or without using the USG), version equal to or greater than 7.1.66.Before proceeding further with the configuration, you need to configure HSNM with a domain and a gateway as described in Adding a New Gateway.PrerequisitesThe prerequisites required for configuration are:Ubiquiti controller version> = 7.1.66 installed on PC / Mac connected to the private LAN or to the USG (Ubiquiti Security Gateway) LAN in the case you use it.AP UniFi connected to the same LAN network private LAN network or to the USG (Ubiquiti Security Gateway) LAN (in the case you use it).HSNM version >= 7.0.142Ability to port forward (refer to “Radius Profile” below) the Radius responses to the UniFi controller.Optional: if you want to use HTTPS login, your LAN/Internet gateway must allow you to enter a static DNS route (in our case, 192.168.1.1 is a MikroTik router).If you don’t need to use HTTPS but only HTTP, you can stop at Step 8 of the “Downloading the Configuration Files” chapter, and you won’t need any particular gateway.If you want to use HTTPS login, your LAN/Internet gateway must allow you to enter a static DNS for the FQDN used to reach the Ubiquiti controller (in our case 192.168.1.1 is a MikroTik router). In case you use USG (Ubiquiti Security Gateway) the static DNS must be added inside USGHSNM gateway configured with Ubiquiti hardware type. When you set the Secret Radius in your HSNM do not exceeds 12 digits code and do not use symbols, otherwise UniFi will not send it correctly.Step 1Now inside HSNM, select your Gateway, click the dropdown menu, and choose Edit. Step 2Expand the General Data session.Step 3In the Hardware Type field, choose Ubiquiti UniFi Controller. Wireless NetworkStep 1Login to your UniFi controller and click the Settings icon on the bottom left.On the left menu, select WiFI and click Create New WiFi Network. Configure with:Name–Edit the name of your networkStep 2In the Advanced Configuration session, select Manual.Step 3In the WiFi Type, tick Guest Hotspot Step 4Once completed, click Add WiFi Network at the bottom right.Radius ProfileStep 1On the left menu, select Profiles and scroll down till RADIUS.Step 2Click Create New RADIUS Profile.In the Radius Profile header, enter the details as follows:Name–Edit the name for your profileEnabled Wired–Tick EnableEnabled Wireless–Tick EnableAuthentication Servers–Edit the Port and insert the SecretEnable Accounting–Tick EnableRADIUS Accounting Server–Edit the Port and insert the SecretEnable Interim Update–Tick Enable (seeufozone/ha-unifi-voucher: UniFi Hotspot Manager Integration
EarlierStep 6Uncheck Encrypted Private Key if you don’t have any type of passphrase set for the certificate, or type the Decryption Password of your certificate Step 7Click Import and choose UniFi as aliasStep 8Set as password aircontrolenterprise and as key pair and re-insert it for confirmationStep 9Click on File > Save asStep 10Set the keystore password aircontrolenterpriseStep 11Upload the new file created in the UniFi folder by replacing the existing “keystore” file.The path of the file depends on the SO version where the UniFi controller is installed.Step 12Restart ace.jar or the controller directly in the case, for example, it is installed in a WINDOWS environment.Step 13If you are NOT using the USG, you have to configure in your gateway the static DNS route (prerequisites) of the FQDN chosen towards the LAN IP of your UniFi Controller (in our case unifi..com – 192.168.1.90)If you are using the USG, If you are using the USG, you have to configure in your USG the static DNS entry (prerequisites) for the FQDN chosen towards the LAN IP of your UniFi Controller(e.g. unifi.yourdomain.com – 192.168.1.90).For further details on how to perform that, read the paragraph “HTTPS Welcome Portal”.Step 14At this time, we can invoke the controller via browser (your gateway IP in a pc/mac in the same network with the first DNS) with the newly configured FDQN. In case the installation of the certificate is successful, you will reach the portal in HTTPS. If you are using the USG and you have not yet created the static DNS entry for the FQDN on USG, you can, in any case, invoke the controller via the FQDN. Simply change the hosts file, on the PC where you would connect, in order to point the USG IP to the valid FQDN (used for the certificate):C:\Windows\system32>notepad c:\Windows\System32\drivers\etc\hosts Save the change and through CMD, test the real changes of the host file with the command: Ping execution unifi.valid-certificate-FQDN.com [IPCONFIG] with 32 bytes of data Reply from IPCONFIG: byte=32 time=1ms TTL=62 Reply from IPCONFIG: byte=32 timeIf you do not get this point with the certificate correctly installed, you will need to check all the previous steps described in the current “HTTPS Keystore” paragraph.HTTPS Welcome PortalStep 1From the Settings menu on the left, under Profiles, edit the default Guest Hotspot and on Redirection, be sure the following options are selected: HTTPS Redirection – Flag itRedirect Using Hostname – Flag itSecure Portal –. 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
GitHub - DJM0/unifi-voucher-generator: Generates UniFi Hotspot
Unifi Hotspot PortalCaptive Portal for Guest Wifi with UnifiAs shown in a video about smart home automations on the german Youtube channel "Spiel und Zeug", I have build a captive portal for my guest wifi network using my Unifi network gear.nThe full video can be found hereThe state of my private implementation was/is not ready for publication as source code due to various reasons, including some bugs.Still under the linked original video there was quite some interest raised to get a guide or runnable solution for it by quite a few people.The idea was to start this repository which might evolve in an actual open source solution with more features and better reliability.For the beginning I am starting an initial Issue for discussion where I will also provide some basic information about the current solution.From time to time I hope to find time to turn it into an open-source solution with the limiting factor of time and lots of other stuff on my list.At the same time I hope to find also contributors helping with the project.ContibutingPlease have a look at the issue #2 for discussions around the current state for the initial release scope & alignments related to contribution of open points.Unifi Unifispot Facebook hotspot login
Contents Table of Contents Bookmarks Enterprise System ControllerRelease Version: 5.3.8 Need help? Do you have a question about the UniFi and is the answer not in the manual? Questions and answers Jochen Unkelbach February 1, 2025 Was muss ich alles tun, um auf mein Netzwerk remote zuzugreifen? 1 comments: Mr. Anderson February 10, 2025 To access a Ubiquiti UniFi network remotely, follow these steps:1. Ensure Remote Access – Use a UniFi Cloud Key, a UniFi Controller on a management station, or host the UniFi Controller in a cloud or NOC.2. Enable Remote Management – Configure the UniFi Controller software to allow remote access.3. VPN Configuration (if needed) – Use a UniFi Security Gateway (USG) to set up a VPN connection by entering the remote router’s hostname, IP address, and shared secret key.4. Layer-3 Adoption (if applicable) – If managing devices across different networks, follow Layer-3 adoption procedures.5. Access UniFi Controller – Use the UniFi Controller’s web interface or mobile app to monitor and manage the network remotely.These steps ensure secure and scalable remote management of a UniFi network. This answer is automatically generated Related Manuals for Ubiquiti UniFi Summary of Contents for Ubiquiti UniFi Page 1 Enterprise System Controller Release Version: 5.3.8... Page 3: Table Of Contents Using the UniFi Controller Software . . . . . . . . . . . . . . . . . . Page 4 UniFi Security Gateway Details . . . . . . . . . . . . . . . . . . Page 5 UniFi Discovery Utility . . . . . . . . . . . . . . . . . . . Page 6 Table of Contents UniFi Controller User Guide Appendix E: Controller Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 7: Software Installation UniFi Cloud Key Users This User Guide is for use with version 5.3.8 or above of the UniFi Controller software. If you have the UniFi Cloud Key, please refer to “UniFi Cloud Key” on page 5 for more information. System Requirements UniFi Cloud Users •... Page 8 Country Code to ensure compliance with FCC regulations. 3. Select the devices that you want to configure and click Next. You can click Refresh Now. 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 beunifi-hotspot/README.md at master - GitHub
UniFi Controller User Guide Windows The Windows files are located in the following location: :\Users\\Ubiquiti UniFi\ data\sites\\portal Customizable Default Files The following default customizable html and css files are located in the portal folder: •... Page 127: Appendix B: Unifi Discovery Utility UniFi Controller software). The Ubiquiti UniFi Discovery Utility includes tools that allow the discovery and management of UniFi APs. It is installed automatically as part of the UniFi Controller software installation process. See “Software Installation”... Page 128 Locate the AP. The following window will appear: Set the inform URL, allowing the AP to be managed by the UniFi Controller software running in a NOC or in the cloud. (See “Network Topology Requirements” on page 1 for a visual representation of this configuration.) The... Page 129 Reset the AP to factory default settings. The following To reboot the AP, click any of the buttons (Locate, Manage, window will appear: or Reset) on the UniFi Discovery Utility screen. The following window will appear: Actions If you clicked the Reset button, then Restore to factory default is automatically selected. Page 130 Appendix B: UniFi Discovery Utility UniFi Controller User Guide Ubiquiti Networks, Inc. Page 131: Appendix C: Unifi Mobile App Register To register for an SSO account, tap The UniFi app has two general functions: Register. • You can use a mobile device to provision a UniFi AP • Continue If you do not want to back up or restore... Page 132 Appendix C: UniFi Mobile App UniFi Controller User Guide 7. Scan the QR code on the back of the UniFi AP, or tap Connected Clients Displays the number of clients Enter ID Manually to type the case‑sensitive MAC connected to this UniFi AP. Page 133 UniFi Controller User Guide Appendix C: UniFi Mobile App Configure WLAN Settings • Name/SSID Enter the name of the wireless network. • Select your country Select the appropriate country from the list. • Enabled Enable or disable wireless functionality. •... Page 134: Controller Mode Tap to save your changes. You can access the UniFi Controller through the UniFi mobile app. Requirements • An Ethernet connection from the UniFi device to the LAN with DHCP • Firmware version 3.4.4.3231 or higher • A compatible Android or iOS device 1. Page 135 8443. • “Settings” on page 137 Note: If you do not know the IP address, you can Dashboard tap Find to detect a UniFiComments
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-26By 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-05By 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-22Network application pre-installed.You will go through the process of configuring the UniFi OS Console on these devices during the initial device setup and configuration and then can launch the Network application and add your UniFi devices.I'm getting a Java-related error during setup, what do I do?The UniFi Network application requires Java, so you'll need to install Java 8 for your specific platform before re-running the installer.The install is not finishing successfully, what could it be?Make sure that all system requirements are met and that all ports used by UniFi are open. If that is all in order, check that the ethernet cables are in good working condition, changing them with others if need be.How do I access the UniFi OS Console configuration page if I don't know my IP?If you haven't set up your console yet, try accessing it by navigating to setup.ui.com or one of the common addresses: localhost:8443 or 192.168.1.1:8443If this doesn't work, you will need to find out the address of your gateway by using commands like ipconfig/ifconfig or device discovery tools like Ubiquiti's WiFiman.I'm getting a "Your connection is not private" security warning when accessing the UniFi OS Console in my browser, should I be concerned?There's nothing to worry about as it's the intended behavior when connecting to your UniFi OS Console locally. Simply proceed to the next page by clicking Advanced > Proceed.How do I upgrade after the initial setup?When a new stable version becomes available, you will receive an upgrade prompt in your dashboard. Click it to upgrade to the latest version. Otherwise go to the UniFi OS Dashboard > System Settings > Updates and check for updates there.What are the UniFi Network application system requirements?For self-hosted software setups, we recommend the following minimum system requirements (make sure to read the Release Notes for more details about a particular version):Operating system:Linux: Ubuntu Desktop / Server 16.04; Debian 9 "Stretch"Windows: Windows 10; Windows Server 2016macOS: Mavericks 10.9, 10.10 Yosemite, 10.11 El Capitan, 10.12 Sierra, 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina.CPU: x86-64 Processor (Intel / AMD x64 Processors)RAM: 2GBNetwork: 100Mbps Wired EthernetHDD: Minimum 10GB free (20GB or more preferred)Java: Java Runtime Environment (JRE) 8Web Browser: Google ChromeMongoDB: version 3.2 or later. Mongo is offered bundled: default is 2.4.14 (for macOS and Windows only).Does the UniFi Network application have to run at all times?Since UniFi devices retain their settings, internet connectivity will work even if the UniFi OS Console is offline.However, the features running directly on the UniFi OS Console will be lost. This includes statistics, reporting, manually applied user groups and the guest hotspot. If you did not set up a WPA security protocol under the guest hotspot's Advanced > Security, then if the Network
2025-04-10