Skip to main content

UnifyOS

Overview​

UnifyOS (UniFi OS Server) is the core management layer developed by Ubiquiti designed to host and run various UniFi applications—such as UniFi Network, Protect, Access, and Talk—on standard Linux environments. By deploying UniFi OS Server inside an LXC container, you can efficiently self-host and manage your Ubiquiti ecosystem on your own hardware or virtualization platform.

LXC Container Specifications​

Official Storage Requirements​

  • /home/: 15.00 GB
  • /var/lib/uosserver: 1.00 GB
  • /usr/local/bin/: 0.12 GB
  • /tmp/: 2.00 GB
  • /var/tmp/: 2.00 GB
  • Memory: 2 GB RAM
  • CPU: 1 vCore
  • Root Disk (/): 8 GB
  • Home Disk (/home): 20 GB
  • Data Disk (/var/lib/uosserver): 2 GB
  • Nesting: Enabled
  • Keyctl: Enabled
  • Privileged Mode: True

Installation​

Execute the following script inside your LXC container to install and configure UniFi OS Server:

install-uos.sh
sudo apt-get update
sudo apt-get install -y podman slirp4netns

# Wrapper sysctl
echo '#!/bin/sh' | sudo tee -a /usr/local/sbin/sysctl > /dev/null
echo '/usr/sbin/sysctl \"$@\" || true' | sudo tee -a /usr/local/sbin/sysctl > /dev/null
echo 'exit 0' | sudo tee -a /usr/local/sbin/sysctl > /dev/null
sudo chmod +x /usr/local/sbin/sysctl

# Install
wget -O install-unifios [https://fw-download.ubnt.com/data/unifi-os-server/5172-linux-x64-5.1.42-12e9e3cf-8f8b-4e54-928c-76b80a10c8a4.42-x64](https://fw-download.ubnt.com/data/unifi-os-server/5172-linux-x64-5.1.42-12e9e3cf-8f8b-4e54-928c-76b80a10c8a4.42-x64)
chmod +x install-unifios
echo -e 'y\n' | sudo ./install-unifios | sudo tee /tmp/install-unifi.log
sudo systemctl enable uosserver
sudo systemctl start uosserver

# Cleaning
sudo rm -f /usr/local/sbin/sysctl
rm ./install-unifios

Once the installation is complete, you can access the web interface via your browser at: https://127.0.0.1:11443