# 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, identity hub, credential server, and supporting services. It is open source and self-hosted, installable on Docker Hub, Proxmox and Unraid.

Canonical page: https://ourlocalhost.com/app/1802/unifi-os-server

## Description

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, Proxmox.

## Health score

59/100 (Fair), based on 5 of 5 factors.
- Maintained: 79 (last commit 58 days ago)
- Popular: 27 (22 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 40 (4 GB minimum RAM, runs on ARM)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/giiibates/unifi-os-server
- GitHub: https://github.com/Gill-Bates/unifi-os-server
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=unifi-os-server
- Unraid: https://ca.unraid.net/apps/unifi-os-server-1fgedxn09kr5hb?q=unifi-os-server

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1802/unifi-os-server), the self-hosted and open-source app directory.
