Repository navigation
Unifi OS Server #1203
Description
Name of the Script
Unifi OS Server
Script Type
VM (Virtual Machine)
📋 Script Details
Application Name
Unify OS Server
Website
https://community.ui.com/releases/UniFi-OS-Server-4-2-23/21df94e9-55d6-4298-b849-fbef3e3b1dd6
Description
Note
- Unify OS Server is still in EA, and it doesn't replace the UniFi Network Server but supersedes it.
- Unlike UniFi Network Server, sources appear to be already containerised
Overview
UniFi OS Server allows users to run the full UniFi OS experience on their own Windows, macOS, or Linux hardware. Initially, it will support the UniFi Network and InnerSpace application.
Benefits of UniFi OS Server (Compared to Self-Hosting Only the Network Application)
Opting for a UniFi OS Server provides several advantages over simply running the standalone UniFi Network application:
- Full UniFi OS Experience: Enjoy the comprehensive and unified UniFi OS interface, providing a consistent management experience similar to that found on official UniFi Consoles.
- Future-Proof Platform: Built on the UniFi OS foundation, this self-hosted solution is better positioned to support new features, updates, and upcoming UniFi applications, offering greater extensibility.
- Unified Updates: Manage updates for the underlying UniFi OS and its applications through a more integrated process.
System Requirements
- Storage:
- Minimum: 20GB of free disk space.
- Software Dependencies:
- The UniFi OS Server installer will typically include necessary dependencies or guide you through their setup.
- On Linux - Podman 4.3.1 or higher.
- On Windows - WSL (Windows Subsystem for Linux) version 2 - installed during setup.
- Ports used:
- 3478, 5005, 5514, 6789, 8080, 8444, 8880, 8881, 8882, 9543, 10003, 11443.
Activity
github-actions commentedon Jan 7, 2026
The unifi-os-server script is ready for testing:
bash -c "$(curl -fsSL https://github.com/community-scripts/ProxmoxVED/raw/main/vm/unifi-os-server.sh)"Note: This is not in the official repo yet—it's just a dev version! After merging into ProxmoxVE, it will need to be recreated.
LightningManGTS commentedon Jan 8, 2026
Had to use https://raw.githubusercontent.com/community-scripts/ProxmoxVED/refs/heads/main/vm/unifi-os-server-vm.sh
When running advanced options after selecting q35 for the chipset got:
✖️ User exited script
/dev/stdin: line 315: DIAGNOSTICS: unbound variable
LightningManGTS commentedon Jan 8, 2026
Similar Message when running as default
⚙️ Using Default Settings
🆔 Virtual Machine ID: 103
📦 Machine Type: Q35 (Modern)
💾 Disk Size: 32G
💾 Disk Cache: None
🏠 Hostname: unifi-server-os
🖥️ CPU Model: Host
🧠 CPU Cores: 2
🛠️ RAM Size: 6144
🌉 Bridge: vmbr0
🔗 MAC Address: 02:65:5A:69:45:AB
🏷️ VLAN: Default
⚙️ Interface MTU Size: Default
🌐 Start VM when completed: yes
🚀 Creating a UniFi OS VM using the above default settings
Validating Storage numfmt: invalid number: ‘Authenticated’
/dev/stdin: line 315: DIAGNOSTICS: unbound variable
/dev/stdin: line 315: DIAGNOSTICS: unbound variable
/dev/stdin: line 315: DIAGNOSTICS: unbound variable
TheOriginalCER06 commentedon Jan 13, 2026
When using "Advanced" I cannot select q35 or i440fx, as selection "OK" gives:
Using "Default" it works and launches. Some timings are of, as "3-5 minutes" took about 20 minutes.
Full log, just for reference, as it did work.
Did not detect VM-ip, idk why.
LightningManGTS commentedon Jan 13, 2026
I know when running Glen's easy unifi script it setups a 1gb swap file when it installs Unifi OS Server. not sure if that would help at all. I also know that when I set the os to 4gb it uses 3ish gb of ram but if I give it 6gb it will use 5ish gb. Performance on controllers remains consistent (although I only have one site in the 3, I tested)
juronja commentedon Jan 16, 2026
Running the script fails with: