this image is intended to be used in combination with an external/linked mongodb instance. as such, it is not operational on its own. apart from that, it ships with default settings suitable for the average deployment.
the examples/ directory contains a suggested deployment setup using docker-compose.
FROM unifi-controller:latest
COPY system.properties /usr/lib/unifi/data/
build the container either manually ( docker build -t my-unifi-controller .
) or via build system (make build
)
if the customized image does not spawn a mongodb server, you must link it to the container or make it otherwise accessible.
docker run -d --name my-running-unifi-controller --add-host=mongo:10.180.0.1 my-unifi-controller
you may need to publish the ports your unifi-controller is listening on to the host by specifying the -p option, for example -p 80:8080 to publish port 80 from the container host to port 8080 in the container. make sure the port you're using is free.
docker run -d --name my-running-unifi-controller --env SYSTEM_IP=10.24.0.1 --link some-mongo:mongo unifi-controller:latest
-
SYSTEM_IP
public address for communication with devices
-
DATADIR
storage directory for configuration.
default: /usr/lib/unifi/data
-
LOGDIR
storage directory for log files
default: /usr/lib/unifi/logs
-
RUNDIR
storage directory for runtime files
default: /usr/lib/unifi/run
-
DB_NAME
database name and name prefix for the stats db
default: unifi-ace
-
MONGO_HOST
host name/address of the mongo db instance
default: $MONGO_PORT_27017_TCP_ADDR or mongo
-
MONGO_PORT
port number of the mongo db instance
default: $MONGO_PORT_27017_TCP_PORT or 27017
docker run -d --name my-running-unifi-controller --link some-mongo:mongo unifi-controller:latest unifi -i 10.24.0.1
to get more information about the supported commandlines, run the image with the -h option
docker run --rm -it unifi-controller:latest unifi -h
docker run -d --name my-running-unifi-controller -v /path/to/unifi/data:/usr/lib/unifi/data:ro unifi-controller:latest
note that your host's /path/to/unifi/data
folder should be
populated with a file named system.properties
. for more
information about its content refer to the
official documentation.
the image is based on the 8-jre-slim-buster tagged openjdk image from the docker library.
the software contained in this image is licensed under the GPL-3.0. additional information can be found on the vendor homepage.
as with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained). it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
Note: this changelog tracks changes to the docker image, not the contained software.
See Ubiquiti release announcements for a list of software releases and their associated changes.
- switch base image from 8-jre to 8-jre-slim-buster
- use buildx for image creation in preparation for multi-arch images.