UniFi OS Server
UniFi OS Server is a container that runs Ubiquiti's full UniFi OS Server stack with systemd-based service management, including the Network Application,…
Platform availability
Available on 2 of 10 platforms
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
59/100 Fair
- Maintained
- 79last commit 58 days ago
- Popular
- 2722 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- 404 GB minimum RAM, runs on ARM
- Security check
- 85no serious findings, CI
Availability: platform listings confirmed today, links checked 5 days ago
- GitHub stars
- 22
- Open issues
- 1
- Last commit
- 2026-09-24
- Latest release
- v5.1.42
- License
- Apache-2.0
- Activity
- stale
Checked 10 days ago - source: GitHub (Gill-Bates/unifi-os-server)
Resources & Compatibility
Minimum requirements: 4 GB RAM, 50 GB disk. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Run the Tailscale UniFi installer first Copy the one-line install command into a terminal on your UniFi OS device and let it finish. It installs the needed Tailscale parts and sets up TUN mode, which is required for sharing your local network. source
- Share your local LAN over Tailscale After connecting the device, run the tailscale up command from the Final TUN Mode section, replacing the placeholder with your home network’s CIDR range. This tells your Tailnet to route traffic through this UniFi machine; without it, other devices can’t reach your local network. source
- Check that TUN mode is active Run ip link show tailscale0 in a terminal and look for a tailscale0 entry. If it isn’t there, TUN mode is probably not active and subnet routing or exit-node traffic may not work. source
- Device Adoption Set the UOS_SYSTEM_IP environment variable to the IP address or hostname of your Docker host; without it, UniFi devices cannot be adopted. source
- First Boot All services take 3–5 minutes to initialize on first start; do not open the GUI until startup is complete, and monitor progress in the container log. source
- GUI Access Access the controller GUI on port 11443 of your host; the site uses a self-signed certificate, so accept the browser security warning. source
Fetched 38 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What environment variable do I need to set so UniFi devices can be adopted?
Set UOS_SYSTEM_IP to the IP address or hostname of your Docker host. Without it, UniFi devices cannot be adopted.
Why does the container seem broken right after the first start?
All services take 3-5 minutes to initialize on first start. Do not access the GUI until startup is complete. You can monitor progress in the Unraid Docker tab container log or with docker logs.
What URL and port should I use for the controller GUI?
Use HTTPS on port 11443 of your Unraid host. The GUI is not ready until first-boot initialization finishes.
Do Trivy vulnerability reports in this image mean I need a custom fix?
Trivy may report HIGH or CRITICAL vulnerabilities from upstream Ubiquiti components. Fixes must come from upstream UniFi OS Server releases and are included after a new upstream version is available.
Does the Docker setup need persistent storage?
Yes, persistent storage must be configured for the UniFi data paths.
Answers sourced from github.com
Community
- Reddit (reddit)
- Topics tagged unifi-os - forum.level1techs.com (forum)
- UniFi-OS-Server - any luck? [SOLVED] - forums.truenas.com (forum)
- I want to use the UniFi OS what is the cheapest solution? (reddit)
- Recommended Most Powerful Self-Hosted UniFi Network Controller ... - Reddit (reddit)
Collected 48 days ago - public community threads