Skip to main content

UniFi OS Server Installation on Ubuntu Server

# Switch to root
sudo -i

# Update and upgrade the system
apt update && apt upgrade -y

# Install required packages
apt install -y podman curl wget ca-certificates gnupg lsb-release

# Optional: Verify Podman version
podman --version

# Create a working directory
cd /opt
mkdir -p unifi-os/4.2.23 && cd unifi-os/4.2.23

# Download UniFi OS Server binary (update version here if needed)
wget https://fw-download.ubnt.com/data/unifi-os-server/8b93-linux-x64-4.2.23-158fa00b-6b2c-4cd8-94ea-e92bc4a81369.23-x64 -O unifi-os-installer

# Make it executable
chmod +x unifi-os-installer

# Run the installer
./unifi-os-installer install

Notes & Tips:

  • Ubuntu Version: Ubuntu 22.04 LTS is recommended. UniFi OS might not behave as expected on older versions due to dependency mismatches or outdated container runtimes.

  • Podman vs Docker: Ubiquiti officially supports Podman for UniFi OS Server as it does not require a daemon and better supports rootless containers. This script installs it system-wide for root.

  • Firewall: Make sure required ports are open (8443, 443, 8080, 3478/UDP, etc.).

  • Persistence: Depending on the deployment type, you may need to manage container data volumes and systemd integration yourself if not handled automatically by the script.

Back to top