unifi-os-server
giiibates/unifi-os-server:latest
https://hub.docker.com/r/giiibates/unifi-os-server
bridge
bash
false
https://forums.unraid.net/forum/47-docker-containers/
https://github.com/Gill-Bates/unifi-os-server
UniFi OS Server running in Docker with full systemd-based service management.
Includes the UniFi Network Application, identity hub, credential server, and all supporting services (PostgreSQL, MongoDB, RabbitMQ, nginx).
Requirements:
- Unraid 6.12 or newer (cgroup v2 required)
- At least 4 GB RAM (6-8 GB recommended)
- Persistent storage configured for all listed paths
IMPORTANT - Device Adoption:
- Set UOS_SYSTEM_IP to the IP address or hostname of your Docker host.
- Without this, UniFi devices cannot be adopted.
First Boot:
- All services take 3-5 minutes to initialize on first start.
- Do not access the GUI until startup is complete.
- Monitor progress: Unraid Docker tab -> Container log, or: docker logs -f unifi-os-server
GUI Access:
https://[your-unraid-ip]:11443
Note: The GUI uses a self-signed certificate. Accept the browser security warning to proceed.
Troubleshooting:
docker logs -f unifi-os-server
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
docker exec -it unifi-os-server journalctl -u postgresql -f
Source: https://github.com/giiibates/unifi-os-server
Network:Management
https://[IP]:[PORT:443]
https://raw.githubusercontent.com/Gill-Bates/unraid-app-templates/main/templates/03_unifi_os_server.xml
https://raw.githubusercontent.com/Gill-Bates/unraid-app-templates/main/icons/03_unifi_os_server.png
--restart unless-stopped --cgroupns=host --cap-add=NET_RAW --cap-add=NET_ADMIN --stop-signal SIGRTMIN+3 --tmpfs /run:exec --tmpfs /run/lock --tmpfs /tmp:exec --tmpfs /var/lib/journal --tmpfs /var/opt/unifi/tmp:size=64m
2026-06-07
Set Privileged=false and add /sys/fs/cgroup:rw mount (required for systemd PID 1 without privileged). Fix WebUI container port (443), add PostgreSQL persistent volume, drop Privileged in favour of explicit caps, add tmpfs mounts and stop-signal, add missing ports, update Overview with Unraid version requirement and first-boot guidance.
bridge
11443
443
tcp
8080
8080
tcp
8443
8443
tcp
8444
8444
tcp
3478
3478
udp
10003
10003
udp
5005
5005
tcp
6789
6789
tcp
9543
9543
tcp
11084
11084
tcp
5671
5671
tcp
8880
8880
tcp
8881
8881
tcp
8882
8882
tcp
5514
5514
udp
/sys/fs/cgroup
/sys/fs/cgroup
rw
/mnt/user/docker/unifi-os/persistent
/persistent
rw
/mnt/user/docker/unifi-os/logs
/var/log
rw
/mnt/user/docker/unifi-os/data
/data
rw
/mnt/user/docker/unifi-os/srv
/srv
rw
/mnt/user/docker/unifi-os/lib-unifi
/var/lib/unifi
rw
/mnt/user/docker/unifi-os/lib-postgresql
/var/lib/postgresql
rw
/mnt/user/docker/unifi-os/lib-mongodb
/var/lib/mongodb
rw
/mnt/user/docker/unifi-os/rabbitmq-ssl
/etc/rabbitmq/ssl
rw
UOS_SYSTEM_IP
HARDWARE_PLATFORM
UOS_SHOW_JOURNAL
false
TZ
UTC
/sys/fs/cgroup