UniFi - Guest Network, Guest Portal and Hotspot System


This article will explain how to create, configure and manage a guest network, along with the optional guest portal and hotspot system.

Table of Contents

  1. Introduction
  2. How to Create a UniFi Guest Network
  3. How to Configure Guest Control and Guest Portal
  4. UniFi Hotspot System
  5. How to Limit Guest Bandwidth
  6. LAN-Wide Client Isolation
  7. Related Articles


Back to Top

This article explains how to configure a guest network, guest portal, and hotspot system if desired. It is important to note the differences between these three.

Guest Networks exist independently from the Guest Portal and/or Hotspot System , which are built-in tools for guest authentication, authorization & accounting. A user on a guest network will face different access restrictions from those faced by the trusted, “corporate” users on default UniFi networks. An administrator can create a guest network, but not enable the guest portal for authentication, or the hotspot, which is a guest management system for free or paid use of the network. On the other hand, to use a guest portal or hotspot system, a guest network must be enabled and configured. This article will explain how to enable all three.

Guest user traffic, by default receives a few important restrictions, including:

  • Other restrictions include Pre & Post-Authorization Access to RFC 1918 Private LAN IP Ranges, as configured, under the Guest Control Settings tab.
  • Client Isolation, which means, Local traffic, such as layer-2 broadcasts, or unicast messages between Guests on the same local, is blocked. By default, this means that guest traffic is only intended to pass upstream or downstream, such as for internet use.


In order for the Guest Portal to function, the UniFi Controller itself must be running at all times. Guests are redirected to the Controller to reach the guest portal, and the redirection will not be successful if the controller is not accessible. See our Related Article on SELFRUN for options.

How to Create a UniFi Guest Network

[Back to Top]

  1. Open up your UniFi Controller and go to Settings > Wireless Networks .
  2. To create a new guest network, select Create New Wireless Network , otherwise edit an existing network.
  3. P rovide a name. This is what users will see when attempting to connect to your Wi-Fi network.
  4. Select the method to be used to authenticate the guest network. A security key may be used, while also leveraging the Guest Portal, or you can leave it Open .
  5. To make this new network a Guest Network, check the box “Apply guest policies…”
  6. Make sure the checkbox for Enable this wireless network is checked. If at some point you wish to disable this network without deleting it, this is where that could be accomplished as well. Click Save .

At this point, the administrator has a working guest network, but more settings can be configured. The next section will explain how to set some guest control and create the guest portal, which is what the network guest users will see when they attempt to access the network.

How to Configure Guest Control and Guest Portal

In the UniFi Controller, the Guest Control section is where administrators configure the custom guest portal and define what subnets they should and should not be able to access before and after authorization.

To Configure Guest Control:

  1. Open the UniFi Controller to Settings > Guest Control .

  2. Under Access Control , you can restrict and give access to hostnames or subnets as follows:

  • In Pre-Authorization Access : Enable pre- and post-authorization guests to access specific hostnames or subnets (external and internal).
  • In Post-Authorization Restrictions : Enable post-authorization restrictions to prevent guests from accessing specific hostnames or subnets.

To Configure the Guest Portal:

  1. In order to require guests to interact with the guest portal, check the box for Enable Guest Portal . Doing so will open additional options including the authentication method associated with the Guest Portal, Expiration Term, etc.

ATTENTION: In order for the Guest Portal to function you will need to buy or generate an SSL certificate for the UniFi Controller.

  1. Under Portal Customization choose between AngularJS and Legacy JSP. AngularJS allows for adjustments and previewing the Portal Customization options. Legacy JSP provides a basic landing page for guests.

User Tip: Customize your portal as little or as much as you want. For the background image, jpg format is recommended. An image of about 920px wide and 640px high is recommended. For the logo image, PNG format and 400px width and height are recommended.

  1. As explained in step 2, the Access Control settings will define subnets necessary for devices to be able to access before and after authorization. An example of a case in which Pre-Authorization Access can be useful is ensuring that devices can access the guest portal before being Authorized—to do this, simply define the subnet that contains the guest portal IP address. Similarly, if there is a subnet on the internal network you do not wish to allow your guests access to after connecting, you can use the Post-Authorization Restrictions to define these.

When troubleshooting cases where users report not being able to access the guest portal, the most common cause seen is not having the Access Control properly configured.

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 redirected to another area of the UniFi Controller for hotspot management exclusively.

Built separately from the UniFi Controller management system (device configuration/adoption sections), trusted employees can be granted limited-access Hotspot accounts to perform actions on Guest users, including:

  • Print vouchers
  • Manage guest authorization
  • Review payments
  • Check guest authentication, and more

Preview of UniFi Hotspot System where Operators can quickly create, customize & revoke vouchers for Internet access.

NOTE: To go straight to the Hotspot Manager page open a new tab or window in a browser and type: https://<ip_or_hostname_of_controller>:8443/manage/hotspot/account/login/

How to Limit Guest Bandwidth

Back to Top

Another useful feature in the UniFi Controller is the ability to limit bandwidth allocation to different user groups. This may be important to ensure guests do not limit the productivity and speed available to permanent users/critical applications. To limit guest bandwidth follow the steps below:

  1. Go to Settings > User Groups .

  2. Click on Create a New User Group .

  3. Define the desired bandwidth limit.

Next, to associate this group to the Guest Network:

4. Go to Settings > Wireless Networks .

5. Click on the corresponding Guest Network and expand Advanced Options .

6. Click the drop-down box next to User Group and select the guest user group.

7. Click Save to apply the changes.

LAN-Wide Client Isolation

Back to Top

Once the guest network is set up on the WLAN (AP) side—it is necessary to make sure the LAN has sufficient isolation, while also allowing common services which may be required (printers, servers, etc.).

In addition to providing the desired client isolation, LAN-side controls on client isolation reduce/eliminate unnecessary broadcast/multicast data, which if left unchecked will have an adverse impact on installation with around 10 or more WLAN APs (see here for details).

The diagram below shows a generalized layout for network-wide (WLAN and LAN) client isolation, while still allowing network-wide core services.

Here’s how to set this up as shown in the above example in the UniFi Controller:

  1. First, open the UniFi Controller that manages your network.
  2. Click the Devices tab on the left to see your devices.
  3. Click on the switch you want to enable port isolation on, and go to the Ports tab.
  4. Either select the ports individually you want to enable port isolation on, or click box to select all.
  5. Click Edit Selected at the bottom.
  6. Go to Advanced.
  7. Expand Advanced Options.
  8. Under Isolation , select Enable port isolation .
  9. Click Apply to finalize changes.

For more advanced configurations related to your guest network see the Related Articles below.

Related Articles

Back to Top

UniFi - Managing Broadcast Traffic

UniFi - Viewing Guest Connection Information

UniFi - Configuring the SELFRUN State

Curated by Liquid Layer Networks

At LiquidLayer.net, we’ve made a shared web hosting platform that’s both feature-rich and easy to make use of. Our programmers have built up a custom Linux cloud web hosting platform plus an innovative Control Panel that perfectly takes advantage of its capabilities. After long hours of programming and bug fixing on our end, we are now capable to guarantee that all of our shared web hosting services are safe, virus-free, full of capabilities and very easy-to-work-with. In addition, they feature 99.9% server uptime as well as 99.9% network uptime warranties.

Powered by:

HostCheetah Networks
Global Web Hosting, Domain Registration and Internet Services
https://hostcheetah.net | http://hostcheetah.uk