unifi

Created: 2025-01-28 18:10:46 | Last updated: 2025-01-28 18:10:50 | Status: Public

I’ll help you install and configure the UniFi Network Application (previously called UniFi Controller) on Ubuntu 22.04.5 LTS. I’ll write this as a step-by-step guide in Python-style documentation format since you’re familiar with Python.

  1. First, update your system and install required dependencies:
sudo apt update && sudo apt upgrade -y
sudo apt install -y ca-certificates apt-transport-https
  1. Add Ubiquiti’s repository:
echo 'deb https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
  1. Add Ubiquiti’s GPG key:
sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg
  1. Install MongoDB (required by UniFi):
sudo apt install -y mongodb-server
  1. Install the UniFi Network Application:
sudo apt update
sudo apt install -y unifi
  1. Check the service status:
sudo systemctl status unifi

The UniFi Network Application should now be running on https://localhost:8443

For configuring VLAN 400 for guest WiFi:

  1. Log into the UniFi controller web interface
  2. Go to Settings > Networks
  3. Create a new network:
   Name: Guest Network
   Purpose: Corporate
   VLAN: 400
   Gateway/Subnet: (Your choice, e.g., 10.40.0.1/24)
   DHCP Range: (Your choice, e.g., 10.40.0.100-10.40.0.254)
  1. Go to Settings > Wireless Networks
  2. Create a new wireless network:
   Name: Guest WiFi
   Security: WPA2
   Network: Guest Network (VLAN 400)
  1. Additional recommended guest network settings:
   Enable guest policies
   Enable client isolation
   Block LAN access
   Optional: Set bandwidth limits

Make sure your switch is configured to pass VLAN 400 traffic between your APs and the UniFi controller.

Would you like me to provide any additional details about specific security settings or VLAN configuration?