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,…

  • Network Services
  • Security
  • Tools & Utilities
UniFi OS Server is a container that runs Ubiquiti's full UniFi OS Server stack with systemd-based service management, including the Network Application, identity hub, credential server, and supporting services (PostgreSQL, MongoDB, RabbitMQ, nginx). It lets homelabbers deploy the complete UniFi controller platform as a single container on Docker, Unraid, or Proxmox with persistent storage.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

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

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

Collected 48 days ago - public community threads