Unifi OS Server

[MickLesk]

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.

[github-actions]

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]

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]

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]

When using "Advanced" I cannot select q35 or i440fx, as selection "OK" gives:

  ✖️  User exited script

/dev/stdin: line 315: DIAGNOSTICS: unbound variable

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.

  ⚙️  Using Default Settings
  🆔  Virtual Machine ID: 106
  📦  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:50:ED:14:CF:C9
  🏷️  VLAN: Default
  ⚙️  Interface MTU Size: Default
  🌐  Start VM when completed: yes
  🚀  Creating a UniFi OS VM using the above default settings
  ✔️  Using local-lvm for Storage Location.
  ✔️  Virtual Machine ID is 106.
  ✔️  Found UniFi OS Server 5.0.6
  ✔️  https://cloud.debian.org/images/cloud/trixie/latest/debian-13-generic-amd64.qcow2
  ✔️  Downloaded debian-13-generic-amd64.qcow2
  ✔️  Downloaded Debian 13 (Trixie) Cloud Image
  ✔️  Expanded disk image to 32G
  ✔️  Cloud-Init configured
  ✔️  Created a UniFi OS VM (unifi-server-os)
   Operating System: Debian 13 (Trixie)    Cloud-Init: yes    Starting UniFi OS VM generating cloud-init ISO
  ✔️  Started UniFi OS VM
  ✔️  VM boot complete
  ✔️  Logged into VM
  ✔️  Podman installed
  ✔️  Downloaded UniFi OS Server installer
  ✔️  UniFi OS Server installed
  ✔️  Guest Agent started
   Detecting VM IP address    Could not detect IP - check VM console 
    🌐  ✓ UniFi OS Server installation complete!
    💡  Access via: https://<VM-IP>:11443
    💡  Console login - User: root / Password: REDACTED
    💡  Note: UniFi OS may take 1-2 more minutes to fully start

  ✔️  Completed successfully!

Did not detect VM-ip, idk why.

[LightningManGTS]

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]

Running the script fails with:

Loading...
bash: -c: line 107: syntax error near unexpected token `}'
bash: line 1: cleanup: command not found
/dev/stdin: line 315: DIAGNOSTICS: unbound variable