unifi-os-server

Overview

UniFi OS Server - A complete UniFi network management platform running in Docker.

This container includes the UniFi Network Application, identity hub, and all supporting services. It uses systemd for proper service management and requires cgroup v2 support.

Requirements:

Docker with cgroup v2 support
At least 2GB RAM
Persistent storage for data

IMPORTANT: Set UOS_SYSTEM_IP to the IP address or hostname of your Docker host.
This is required for UniFi device adoption to work correctly.

Features:

UniFi OS Server GUI/API (port 11443)
UniFi Network Application (port 8443)
Device and application communication (port 8080)
Mobile speed test (port 6789)
Hotspot portal with SSL support (port 8444)

Troubleshooting:
docker exec -it unifi-os-server systemctl list-jobs
docker exec -it unifi-os-server ss -tulpn
docker exec -it unifi-os-server journalctl -u unifi-core -f

Source: https://github.com/giiibates/unifi-os-server

Runtime arguments

Web UI: https://[IP]:[PORT:11443]
Network: bridge
Shell: bash
Privileged: true
Extra Params: --restart unless-stopped --cgroupns=host

Template configuration

UOS System IP/HostnameVariable

REQUIRED: IP address or hostname of your Docker host (e.g. 192.168.1.10). Used for UniFi device adoption and remote management.

Target: UOS_SYSTEM_IP

Hardware PlatformVariable

Optional: Set to 'synology' if running on Synology NAS

Target: HARDWARE_PLATFORM

TimezoneVariable

Container timezone (e.g. UTC, Europe/Berlin)

Target: TZ
Default: UTC

UniFi OS Server GUIPorttcp

UniFi OS Server GUI/API Port

Target: 11443
Default: 11443

Device CommunicationPorttcp

Device and application communication port (required for adoption)

Target: 8080
Default: 8080

UniFi Network AppPorttcp

UniFi Network Application GUI/API

Target: 8443
Default: 8443

Hotspot PortalPorttcp

Secure Portal for Hotspot

Target: 8444
Default: 8444

STUNPortudp

STUN for device adoption

Target: 3478
Default: 3478

Device DiscoveryPortudp

Device discovery during adoption

Target: 10003
Default: 10003

RTPPorttcp

Real-time Transport Protocol

Target: 5005
Default: 5005

Mobile Speed TestPorttcp

UniFi mobile speed test

Target: 6789
Default: 6789

Identity HubPorttcp

UniFi Identity Hub

Target: 9543
Default: 9543

Persistent DataPathrw

Path for persistent container data

Target: /persistent
Default: /mnt/user/docker/unifi-os/persistent

LogsPathrw

Path for container logs

Target: /var/log
Default: /mnt/user/docker/unifi-os/logs

UniFi DataPathrw

Path for UniFi application data

Target: /data
Default: /mnt/user/docker/unifi-os/data

srv DirectoryPathrw

Path for srv directory

Target: /srv
Default: /mnt/user/docker/unifi-os/srv

UniFi LibraryPathrw

Path for UniFi library data

Target: /var/lib/unifi
Default: /mnt/user/docker/unifi-os/lib-unifi

MongoDB LibraryPathrw

Path for MongoDB data

Target: /var/lib/mongodb
Default: /mnt/user/docker/unifi-os/lib-mongodb

RabbitMQ SSLPathrw

Path for RabbitMQ SSL certificates

Target: /etc/rabbitmq/ssl
Default: /mnt/user/docker/unifi-os/rabbitmq-ssl

Links

Template Support Docker Hub Project

Details

Repository

giiibates/unifi-os-server:latest

Registry

https://hub.docker.com/r/giiibates/unifi-os-server

Last Updated2026-05-22

First Seen2026-05-15

Run unifi-os-server on Unraid.

unifi-os-server is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS