[Script request]: Unifi OS Server

[jeremyswann]

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.

Due Diligence

• I have searched existing scripts and found no duplicates.
• I have searched existing discussions and found no duplicate requests.

[xkpx64]

+1

[MickLesk]

Only as VM possible. Lxc Not.
Its in EA, so Not yet

Edit: ive tested it in DEV Repo, but in 20 trys i cannot get it to work. Everytime the same issue "no such file or directory os error 2" - idk. Waiting

[LightningManGTS]

People said they have managed to make it work using Ubuntu VM's just by installing podman on the release thread.

Can confirm using the ubuntu script https://community-scripts.github.io/ProxmoxVE/scripts?id=ubuntu2504-vm

I was able to run updates, install podman, and then download and run the package from the release thread and it just worked, an LXC would still be more ideal but this is fine for now.

[MickLesk]

Then i try tomorrow with 25.04

[MickLesk]

Bad, with 25.04 it works, with debian 12 and ubuntu 24.04 not. Maybe we wait a little bit more. 25.04 is not an LTS

[LightningManGTS]

Weird, what error messages were you getting on 24.04? Debian 13 release is in like 5 days so targeting that wouldn't be awful if it's the 6.14 kernel that's making it work.

[bauerpawel]

More info: https://www.virtualizationhowto.com/2025/08/new-unifi-os-server-lets-you-self-host-the-full-unifi-experience/

[J-Smits]

following this topic, also searching for a script to use the Unifi OS server under Proxmox

[b0ssman]

here is a docker compose implementation https://github.com/lemker/unifi-os-server

[christiaangoossens]

UniFi OS Server stable has been released: https://community.ui.com/releases/UniFi-OS-Server-4-3-6/6203a43a-d19b-43ee-9cf9-835522f19eae

[snorkrat]

+1

This would be great as an LXC if possible!

Thanks for all the great work as usual.

[MickLesk]

only possible as vm, not as lxc. it need many kernel features

[blunden]

This guy seems to have made it work in an LXC container. I haven't tried it, but I figured posting a link to it here might be helpful. 🙂

https://github.com/kam821/Unifi-OS-Server-on-LXC-Proxmox

[MickLesk]

LXC > http://github.com/community-scripts/ProxmoxVED/issues/1288
VM > community-scripts/ProxmoxVED#1203

Feedback !

[MickLesk]

LXC merged to Main.