LinkedIn
GitHub
The UniFi Network Controller is a free software suite that allows you to set up, configure, manage, and analyze your UniFi network in a centralized manner. Normally Unifi Controller runs in Cloud Providers or in the data center using the Unifi Cloud Key.
This image, allows you to run Unifi Network Controller in Kubernetes using the ARM64 architecture. It has been tested Raspberry-Pi 4B running Rancher's K3s. The main idea before building this image was to execute this with a decoupled MongoDB database, to improve availability, resiliency, and performance.
The image includes the mongodb binaries because the Unifi Network Controller software needs it to execute, but the server must be running externally.
Typically Unifi Controller configures two different MongoDB databases, ace for the configuration itself and ace_stats to store networking metrics.
You need to create your MongoDB cluster before using this image. A few examples of the Kubernetes configuration have been included in this repository.
The following Environment variables require to be initialized before running.
| Variable | Value | Default |
|---|---|---|
DEBUG |
Enables init scripts debug mode | false |
JVM_MAX_HEAP_SIZE |
JVM Maximum Heap Size | --- |
JVM_INIT_HEAP_SIZE |
JVM Minimum Heap Size | --- |
BIND_PRIV |
Bind service privately | false |
DB_MONGO_LOCAL |
Run local MongoDB instance | --- |
DB_MONGO_URI |
MongoDB URI | --- |
STATDB_MONGO_URI |
StatDB Mongo URI | --- |
UNIFI_DB_NAME |
Name of the UNIFI database | --- |
RUN_CHOWN |
Update permissions at init | true |
You need to have an ARM64 cluster with a MongoDB accessible by the Unifi Controller pods. Check the Kubernetes directory to see examples.
- 6789/tcp - No data.
- 8080/tcp - Device command/control
- 8443/tcp - Web interface + API
- 8843/tcp - HTTPS portal
- 8880/tcp - HTTP portal
- 8080/tcp - API
- 3478/udp - STUN service
Based on goofball222/unifi Docker images.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.