UniFi OS Server | Glance & FAQ

Q&A

Q1. Where can I find the official release notes for UniFi OS Server (UOSS)?

A:
The release notes are available here:
https://community.ui.com/releases/UniFi-OS-Server-4-2-23/21df94e9-55d6-4298-b849-fbef3e3b1dd6
Note: UI account & Early Access required.

Q2. Can I migrate sites running on a self-hosted UniFi Network Application (UNA) server to the new self-hosted UniFi OS Server?

A:
Yes. The process is the same as migrating (export/import) sites between UCKs/UNAs. The UniFi OS Server still uses the default inform port 8080.

Q3. Does Site Magic (SD-WAN) work with UOSS?

A:
Yes, it works flawlessly—tested with UXGs. There is no need for a Cloud Gateway (e.g., UDM/UCG) or UCK. You can set up Site Magic between all gateways running UniFi OS, including the new self-hosted UOSS.
Note: Not tested with USG or legacy gateways; they likely won't work.

Q4. How do I install UOSS? Is it complicated?

A:
Installation is straightforward for both single-site and multi-site deployments. There are several YouTube videos and articles demonstrating UOSS deployment on Windows, Linux, and macOS—check the reference section below.
For home or personal use (one site), I still recommend using Cloud Gateways (UDM series) for easier setup and management.

Q5. Should we migrate all sites from legacy UNA hosting or Cloud Keys to the new UOSS right now?

A:
Not recommended for production/business use—at least not yet.
While deployment and migration are smooth and familiar, and testing has been positive, UOSS is still in Early Access as of this writing.
Key notes:

• For commercial environments, UOSS/UNA should be deployed on a proper Linux server (not Windows/macOS). However, documentation on hardware requirements and Linux dependencies is still incomplete.
  • Resource usage (Network app only): About 1.8GB RAM and 12.9GB disk space (my test: Debian 12 VPS, 4c4g, single site, 14 devices, ~60 clients).
  • Compatibility: Debian 12, RHEL 10, Oracle Linux 9, Ubuntu 22.04, and even WSL confirmed by the community.
  • Known issue: Linux UOSS cannot update in-place (no upgrades from the control panel or app menu)—requires full reinstall and backup/restore.
• There is little community support or troubleshooting documentation, and currently no proper way to uninstall UOSS cleanly if something goes wrong. (updated on 10 Aug 2025 - To uninstall UOSS, use "uosserver-purge".)
• In summary: As a network management platform, the current UOSS release lacks clear documentation, serviceability, scalability, redundancy, resource, and community support. Try it, but don’t rely on it for business-critical production yet.

Q6. Do I need to set up SSL certificates for UOSS? How?

A:
Not strictly necessary, but highly recommended for security.

• The default WebGUI port is 11443; it seems UI encourages management through the UniFi Site Manager instead of direct UOSS access.
• Two easy ways:
  1. Use your own SSL certs:
     Go to Settings → Control Panel → Console → Certificates → Add New to upload your key and certificate. Add a DNS record for your domain pointing to your UOSS IP (Cloudflare etc.).
  2. Automate with Let’s Encrypt:
     Use this script by Mirano to automatically import and renew Let’s Encrypt certificates.

Q7. Can I manage UniFi devices at sites without a UniFi gateway (e.g., third-party gateway but UniFi APs/switches)?

A:
Yes. As long as devices are adopted into a site on your UOSS, it works.

• If UOSS is off-site, use SSH set-inform (advanced L3 adoption), or the UniFi app if UOSS is bound to your UI account.
• The adoption process is the same as old UNA servers.
• Useful tools:
  • HostiFi Device Discovery Tool (also works on macOS and smartphones)
  • UniFi Easy Remote Adoption script by @Glenn R.

Tips

1. Backup, backup, backup!
   Always backup before making any changes—export sites from UCK/UNA, snapshot self-hosted UNA before upgrades.
2. Version match:
   Try to match the UniFi Network Application version between UOSS and the source UNA/UCK before migration. Upgrade the old system to the same version if possible.
3. Check community resources:
   Always read release notes and community discussions before installing or upgrading UOSS.
4. Use a clean server:
   Deploy UOSS on a fresh Linux instance to avoid port conflicts and other issues. (Hopefully, UI will support container/Docker deployment in the future.)

Summary & Key Takeaways

• UOSS is a major leap forward for the UniFi ecosystem, unlocking true scalability, especially for large/multi-site deployments.
• x86/ARM64 hardware means no more reliance on proprietary appliances (UCK/UCG), and no more controller performance bottlenecks.
• With secure cloud hosting and Site Magic, you can finally host the controller off-site, avoiding common issues (like inform address drift) that caused Site Magic drops with local Cloud Keys behind NAT/firewall.
• UniFi has its bugs, but it’s “license-free” and doesn’t stack on recurring subscription costs.

References & Further Reading

• Official Release Post (UI login required)
• Introducing UniFi OS Server for MSPs
• Crosstalk Solutions: Best Practices for UOSS on Linux
• LazyAdmin: UOSS Review & Installation Guide
• Let’s Encrypt SSL Script by Mirano
• Glenn R. UniFi Scripts
• SKK Blog: Home Network Setup

If you have more questions about UOSS or want to discuss specific setups, feel free to leave a comment below. I’m happy to test with the UniFi devices I have and share further results.