UniFi Common Tasks

From MattWiki
noteThis Page was written with UniFi Controller version 5.7.4 in mind, and may not work correctly with other versions.

Below is a list of common tasks you may need to complete on a UniFi network.

Connecting to the UniFi Controller

  1. In your web browser, go to the web address https://192.168.1.9:8443/manage/account/login.
  2. In the Username box, enter ubnt (all lowercase).
  3. In the Password box, enter the password found on The Rude Family Network - IP Address Map.xlsx document within this same folder.

Changing the WiFi Password

  1. Connect to the UniFi Controller and go to Settings (gears on the bottom left) then choose Wireless Networks from the submenu.
  2. Click the Edit button to the left of the Odin network.
  3. Enter the new password in the box labeled Security Key.
  4. Click Save to save the changes.
  5. The access points will now provision to update the changes.

Blocking a single device from accessing Wi-Fi

  1. Connect to the UniFi Controller and go to the Clients section.
  2. Find the client/device in the list of clients and click Block.

Unblocking a device to allow access to Wi-Fi

  1. Connect to the UniFi Controller and go to the Insights section.
  2. On the top left, choose the dropdown labeled Neighboring Access Points and switch it to Known Clients.
  3. The default view is to show the clients that have connected to the network in the last 24 hours. If the device was blocked more than 24 hours ago, you must change the Show dropdown box, on the top of the page, to a time period greater than when it last connected, or just choose All.
  4. Find the device in the list of known clients and click unblock.

Disable the Guest Wi-Fi Network

The following will disable the Guest Wireless (Wi-Fi) network or all users and all access points on the network.

  1. Connect to the UniFi Controller and go to Settings then choose Wireless Networks.
  2. Click the Edit button to the left of the Odin-Guest network.
  3. Uncheck the checkbox next to Enabled to disable the Guest Wireless network.
  4. Click Save to save the changes.
  5. The access points will now provision to update the changes

Disable/Enable the Status Light (LED) on an Access Point

Method 1: Disable the status light on a single wireless access point.

  1. Connect to the UniFi Controller and go to Devices.
  2. Click on the device you wish to change the status light on.
  3. On the new Properties window that opened on the left, choose Config from the top tabs.
    • Choose Use site settings to set the device to use the default setting (see Method 2 below)
    • Choose On to force the light to be on regardless of the default setting.
    • Choose Off to force the light to be off.
  4. Once complete, choose Save, to save your changes.

Method 2: Disable all status lights on all devices

  1. Connect to the UniFi Controller and go to Settings then choose Site.
    • Add a checkmark to Enable Status LED to enable the status light.
    • Remove the checkmark on Enable Status LED to disable the status light.
  2. Click Apply Changes on the bottom left of the page.

Backing up the Network Configuration

  1. Connect to the UniFi Controller and go to Settings then choose Maintenance.
  2. Click the Download Backup button to download a backup contacting the full settings of the network and the last 7 days of DPI data.
    1. You may choose a different deration for the DPI data using the dropdown box to the left of the Download Backup button.  If you do not wish to download any DPI data, choose Settings Only from the dropdown box.

Restoring the Network from a Backup File

Method 1: From a working Controller

  1. Connect to the UniFi Controller and go to Settings then choose Maintenance.
  2. Under the Restore heading, click the Choose File button.
  3. A new window will open up asking for the name and location of the file you wish to restore the backup from.  You must find the already backed up file on your file system then choose Open.

Method 2: From a disabled Controller

Method 3: From a newly installed Controller

Adding a New Device to the Network

  1. Plug your new device into the network.
  2. Connect to the UniFi Controller and go to Devices.
  3. Find the new device in the list and click Adopt.

Removing an Old Device from the Network

  1. Connect to the UniFi Controller and go to Devices.
  2. Click on the Device you wish to remove, the Properties window will open on the righthand side.
  3. Click Config near the top of the Properties window.
  4. Click the plus (+) symbol to expand the Manage Device section.
  5. Scroll down to Forget This Device and click Forget.

Changing the Network Administrator Password

Note Note: The Network Administrator Username and Password is the account used to log into the UniFi Controller web interface.
  1. Connect to the UniFi Controller and go to Settings then choose Admins from the submenu.
  2. Choose the Edit button to the left of the ubnt user account.
    1. Enter the current password in the Password box.
    2. Enter the new password twice, once in the New Password box, and once in the Confirm Password.
  3. Click Submit to save the changes.

Changing the Network Device Password

Note Note: The Network Device Username and Password is the account that allows a user to connect to a device via SSH, not the UniFi Controller. This account is also the account used be the devices to communicate with the controller.
  1. Connect to the UniFi Controller and go to Settings.
    • You should already be in the correct section, the Site section.
  2. Enter the new password in the Password box under the label Device Authentication.

Upgrading the CloudKey Firmware

Upgrading the UniFi Controller Software on the CloudKey

Install Beta UniFi Controller Software on a CloudKey