Warning
Ubiquiti now offers an officially supported way to self-host the UniFi Network application on your own hardware: Self-Hosting UniFi (UniFi OS Server). Because it is maintained by Ubiquiti directly, it is the recommended path going forward and this community image is no longer needed.
No further version updates will be published here. The existing images remain available for now, but you should plan to migrate to UniFi OS Server.
See that guide for installation and migration instructions.
Docker images for running Ubiquiti's UniFi Controller software.
10.1.89,10.1(v10.1.89/10.1)10.2.105,10.2(v10.2.105/10.2)10.3.58,10.3(v10.3.58/10.3)10.4.57,10.4,10,latest(v10.4.57/10.4)
Ubiquiti releases 'unstable', 'testing', and 'stable candidate' versions as part of its beta group release structure. These releases are included here. Only stable releases are tagged with their general version (ex: 5.6 for the 5.6.30 stable release) or with latest.
| Architecture | Available | Tag |
|---|---|---|
| amd64 | ✅ | <version tag>-amd64 |
| arm64v8 | ✅ | <version tag>-arm64v8 |
| arm32v7 | ❌ |
Note: arm32v7 is no longer supported due to a lack of upstream support for mongodb <= 3.6 for arm32/armhf
As of 7.5.x, this container image supports unifi's standard configuration utilities.
You can supply a system.properties file at /var/lib/unifi/system.properies (in the container) or set any of the following environment variables:
| Environment Variable | Description | Default |
|---|---|---|
| JVM_INIT_HEAP_SIZE | Initial Java heap size in MiB | None |
| JVM_MAX_HEAP_SIZE | Maximum Java heap size in MiB | 1024 |
| JAVA_ENTROPY_GATHER_DEVICE | Path to entropy gathering device | None |
| UNIFI_JVM_EXTRA_OPTS | Additional JVM options | $JAVA_OPTS |
Additionally, -XX:+UseParallelGC is used by default but can be changed with the unifi property unifi.G1GC.enabled.
Documentation is in the wiki.
./build.sh -v <docker version> -u <unifi version> [-t <additional docker tag> ...]
Example: ./build.sh -v 5.9.29 -u 5.9.29-04b5d20997 -t 5.9 -t 5 -t latest
./publish.sh -v <docker version> -u <unifi version>
Example: ./publish.sh -v 5.9.29 -u 5.9.29-04b5d20997
./tag.sh -v <docker version> -u <unifi version> [-t <additional docker tag> ...]
Example: ./tag.sh -v 5.9.29 -u 5.9.29-04b5d20997 -t 5.9 -t 5 -t latest