UniFi Support Tools

IT Pro Expert – Supporting Ubiquiti UniFi Solutions – Cheat Sheet

---

1. Default Logins & Credentials & IPs

(Verify which generation of device you are using)

Factory Default State (Unadopted)

Device Generation	Username	Password	Note
Legacy / Standard	ubnt	ubnt	Older APs, Switches, USG
Newer UniFi OS	ui	ui	UDM, UXG, Newer APs

UniFi Default IP:

Gateways: 192.168.1.1 or 192.168.2.1 (rare 10.0.0.1)

Others: 192.168.1.20

Adopted Devices

Once adopted, SSH credentials are controlled by the Network Application:

• Modern UI: Settings > System > Advanced > Device Authentication (Click the “Eye” icon to reveal).
• Legacy UI: Settings > Site > Device Authentication

---

2. SSH Commands Cheat Sheet (Legacy)

Device Management (General)

Works on most Access Points and Switches.

• info
  • Function: Displays device status & adoption URL.
• set-inform <url>
  • Function: Set Controller URL for adoption.
  • Example: set-inform http://192.168.1.10:8080/inform
• upgrade <url>
  • Function: Upgrade firmware via URL.
  • Example: upgrade https://dl.ui.com/path/to/firmware.bin
• reboot
  • Function: Reboot the device.
• ping <ip>
  • Function: Check internet/gateway connectivity.

Camera Specific Commands (G3/G4/G5)

Use these for UniFi Protect cameras.

• ubnt_system_util reset-default
  • Function: Factory Reset (Modern Cameras).
• cp /usr/etc/system.cfg /tmp/system.cfg; cfgmtd -w -f /tmp/system.cfg; reboot
  • Function: Factory Reset (Legacy G3 Cameras). Use this if the standard reset command fails.

UniFi OS Specific (UDM, UDR, UXG)

Commands specific to the new UniFi OS architecture.

• ubnt-systool cputemp – Show CPU Temperature.
• ubnt-systool portstatus – Show physical port link status.
• unifi-os restart – Restart the UniFi OS container/service.
• ubnt-device-info summary – Show detailed system summary.

Legacy & Advanced Commands

For older devices (USG) or deep troubleshooting.

cat /var/etc/persistent/cfg/mgmt – View management config (Check where the device is trying to “phone home”).

syswrapper.sh restore-default – Force Factory Reset (APs/Switches).

mca-cli – Enter the UniFi CLI shell (USG only).

---

3. Network Ports Reference

Essential for Firewall Configuration.

Ingress Ports (Incoming to UniFi OS Server)

11443	TCP	UniFi OS Server Web UI (GUI/API)
8080	TCP	Device Inform. This is the primary port devices use to "phone home" to the server and Guest Portal.
3478	UDP	STUN. Used for NAT traversal to help devices find the server.
10001	UDP	Device Discovery. Used to "find" devices on L3 networks for adoption.
10003	UDP	New Port for UniFi OS Server - [Unknown use]
1900	UDP	L2 Discovery [Not required on UniFi OS Server - Legacy Network Server Port]
443	TCP	Remote Access. For connecting your server to unifi.ui.com and for secure WebSockets.
8443    TCP     Legacy Port from Network (Not required on UniFi OS Server)
8881	TCP	Guest Portal (HTTP)
8882	TCP	Guest Portal (HTTP)
8843	TCP	Guest Portal (HTTPS) - [Currently not in the release candidate listing] [Legacy Guest Portal HTTPS]
8444	TCP	Secure Guest Portal (HTTPS)
8880	TCP	New Port for UniFi OS Server - [Unknown use] [Legacy Guest Portal HTTP]
6789	TCP	UniFi Mobile App Speed Test
5005	TCP	New Port for UniFi OS Server - [Unknown use]
9543	TCP	New Port for UniFi OS Server - [Unknown use]
11084	TCP	New Port for UniFi OS Server - [Unknown use]
Lock Down Port
22	TCP	SSH - Locked to your admin IP. Don't expose this to the world.
Optional
5514	UDP	Remote Syslog Capture
27117	TCP	Local Database Comms [Not listed as required port]

Make sure you get your TCP and UDP settings correct and check the reference article for any additional ports you may require.

---

4. NextDNS for UniFi OS

Install NextDNS CLI directly on UDM/UXG/UDR.

Installation Command:

Bash

sh -c 'sh -c "$(curl -sL https://nextdns.io/install)"'

Setup Script “Best Practice” Options:

When running the installer, use these recommended settings:

1. Report Device Name: Y (Allows you to see which device is making queries in logs)
2. Setup as a Router: Y
3. Enable Caching: Y
4. Enable Instant Refresh: Y
5. Automatically setup local host DNS: Y

Useful NextDNS Commands:

• nextdns status – Check if running.
• nextdns start / nextdns stop – Control service.
• nextdns restart – Restart service.
• nextdns log – View live query logs.
• nextdns config – View current configuration.

Important: Disable “Content Filtering” and “Ad Blocking” in the UniFi Network Application (Settings > Networks & Settings > Security) to prevent conflicts.

---

5. Essential Tools & Downloads

Antenna Radiation Patterns

• UniFi AP Radiation Patterns:View Official Radiation Plots
  • Use this to understand signal propagation (Azimuth/Elevation) for correct AP placement.

Calculators & Discovery

• UniFi Protect Storage Calculator: zufall.co/protect-calculator
• UniFi Capacity Calculator: ui.com/cloud-gateways/resource-calculator
• Device Discovery: Use Ubiquiti WiFiman (Mobile/Desktop) or the Network App. (Chrome App is Deprecated).

Legacy Manuals

• UniFi Controller V5 User Guide: Download PDF
• Legacy AP User Guide: Download PDF

---

6. Guide: Setup New UniFi OS Server (Self-Hosted)

This guide outlines the “Same Server” migration method referenced from UniFi Legacy Network to UniFi OS Server Migration.

Phase 1: Backup & Prepare

1. Prepare OS: Wipe your server and install Ubuntu 24.04 LTS.
   • Minimum Specs: 2 vCPU, 2GB RAM, 20GB Storage ideally 4vCPU, 8GB RAM, 50GB SSD.
2. Firewall: Ensure ports 443, 8080, and 3478 are open.

Phase 2: Installation

1. Install Dependencies:Bashsudo apt-get update && sudo apt-get install podman slirp4netns
2. Install UniFi OS:
   • Go to ui.com/download > UniFi Cloud Gateways.
   • Copy the link for “UniFi OS Server for Linux”.
   • Run the following (replace [LINK] with your copied URL):
   Bashcurl -O [LINK] chmod +x [DOWNLOADED_FILENAME] ./[DOWNLOADED_FILENAME] install

Phase 3: Setup

1. Initial Setup:
   • Open https://your-server-ip:11443 in your browser.
   • Sign in with your UI.com account and set it up as a “New Console”.
2. System Setup:
   • Once logged into the UniFi OS Dashboard, open the Network Application and Configure.
   • Reboot and make sure backups are working.

---

UniFi OS Server Health Monitoring Script

Monitor your self-hosted server for Low RAM//CPU/Disk Space – optional auto reboot and get alerts via Pushover.

• View and Copy the Health Script Here

NOTE: Additional UniFi Support information can be found in the articles on this website.