Support Downloads Community

UniFi Video is an obsolete product line.

This application and its related devices will no longer receive any manner of technical support, including functional and security updates. Additionally, there will be no further updates to Help Center content pertaining to UniFi Video.

UniFi - Configuring the SELFRUN State


This article describes how to configure the behavior of UniFi Access Points (UAPs) on selfrun mode, the state in which APs enter when they cannot reach the UniFi Network application. This will directly affect the Guest Portal.

This configuration requires editing the file, and is recommended only for advanced users. Read more about the file in this article: UniFi - Explaining the File.

Table of Contents

  1. Introduction
  2. How to Configure SELFRUN
  3. Testing and Verification
  4. Related Articles


Back to Top

When an access point cannot reach the UniFi Network application, it goes into selfrun mode. In this state, it will not redirect guests to the Guest Portal because it is not reachable. Instead, the AP will automatically allow guests to use the network without redirecting to the portal first. It will however maintain guest and user group policies as follows:

  1. The guest access policies will still be effective (L2/L3 isolation) along with the restricted subnets feature.
  2. The user group (bandwidth limiting, etc) associated with this WLAN will still be effective.
  3. If a password was set in Settings > Wireless Networks > Edit (or Create) > Security, then guests will still be prompted to provide that password before being granted access. If Security was set to Open however, and the guest network was relying on the Guest Portal security (set in Settings > Guest Control > Simple Password > Guest Password) then users will be able to access the guest network freely.
  4. When the Network application comes back online, the Guest Portal redirection feature will restore automatically.

Read more about Guest Networks and Policies in this article.

How to Configure SELFRUN

Back to Top

There are two possible selfrun behaviors an AP can follow. The first allows all guests to access the network, while still retaining guest access policies as described in the section above. This means they just bypass the guest portal. This happens when selfrun is configured to pass. The second behavior, which occurs when selfrun is set to off, will have all guest wireless networks (any and all that are configured for this UniFi Network application) disabled when the application is not reachable.

IMPORTANT: The Guest Portal must be enabled for this configuration to work.

To add either one of these configurations follow these steps:

1. Open (or create) the file. Learn more about how here

2. Add one of these lines depending on which behavior is needed:




3. After adding the line to the file, a provision must be triggered on all APs. Trigger a provision by making a change related to the access points in the UniFi Network application. You can also trigger a provision in the access point's properties panel > Device > Trigger Provision.

Testing and Verification

Back to Top

To check whether the configuration has been taken by the access point, SSH into the AP and execute:

cat cfg/mgmt

If everything is running in order the output should provide the line you added to the file, preceded by mgmt instead of config. For example, you'll see the following:


Related Articles

Back to Top

UniFi - Explaining the File

UniFi - Guest Network, Guest Portal and Hotspot System

Intro to Networking - How to Establish a Connection Using SSH

Was this article helpful?
42 out of 57 found this helpful