stellirin/unifi-controller repository overview

⁠UniFi Network Controller

The UniFi® Software-Defined Networking (SDN) platform is an end-to-end system of network devices across different locations — all controlled from a single interface.

⁠Migration to GitHub Packages

Due to various⁠ hostile⁠ actions⁠ by Docker Inc. over the years, new images of unifi-controller are now hosted at GitHub Packages. There you will find container images based on the latest 7.x releases of the (renamed) UniFi Network Application.

The container images of the 5.x releases of UniFi Network Controller that were hosted here, the last of which was pushed in September 2020, are obsolete and have been removed.

⁠Quick reference

• Where to get help: The UniFi Community Forums⁠
• Where to file issues: https://github.com/stellirin/unifi-controller/issues⁠
• Maintained by: Adam Farden⁠
• Supported architectures: amd64

⁠What is the UniFi Network Controller?

The UniFi Network Controller is the front end for the UniFi Software-Defined Networking (SDN) platform, an end-to-end system of network devices across different locations.

This project is not an official container image, nor is it associated with Ubiquiti in any way. It was created by reverse engineering the original UniFi scripts.

Motivation for this project comes from the limitations of the source DEB. Specifically, the DEB is restricted to use MongoDB v3.4 because of how the UniFi scripts connect to a locally installed DB. However, UniFi runs perfectly fine on MongoDB v4.0 when connecting to a 'remote' MongoDB installation (i.e. via URI instead of socket).

By default the controller will generate untrusted TLS certificates. This container can also use trusted certificates, for example from Let's Encrypt. The container will also watch any provided certificates for changes and trigger a restart.