Skip to content
Rich Brown edited this page Jun 2, 2026 · 6 revisions

Welcome to unifi-os-server Wiki

This repo contains a Dockerized version of Ubiqiti Network's Unifi OS Server. This container lets you run a self-hosted server that shows the state of all your Unifi devices in a single dashboard.

Why bother with Docker? Using Docker, you can stop worrying about finding and installing the right versions of all the dependencies on your server. You also avoid version hassles and update notices for the application, Java, or your OS. A Docker container wraps everything into one well-tested bundle.

To install, modify a few couple lines in the config file, then type docker compose up -d on the command line. To upgrade, stop the old container, pull a new Docker container, and start it again. It's really that simple.

This container has been tested on [these need checking: Ubuntu, Debian, macOS, Windows,] and even Raspberry Pi hardware.

Read the Getting-Started page for system requirements and the steps for installing, starting, and updating the container

Read the Troubleshooting page for various tips for diagnosing and fixing your installaton.

If you are moving from Unifi Network Controller or another Unifi OS Server, read the Migration-Guide.

Clone this wiki locally