[(Dockerfile)]: https://code.crute.me/mcrute/dockerfiles/tree/unifi/Dockerfile
[Changelog]: https://community.ubnt.com/t5/UniFi-Updates-Blog/UniFi-5-6-20-Stable-has-been-released/ba-p/2119397?attachment-id=85425

# Supported tags and respective `Dockerfile` links

* `5.6.20`, `stable` [(Dockerfile)][] [Changelog][]


[![unifi](https://dl.ubnt.com/press/logo-UniFi.jpg)](https://unifi-sdn.ubnt.com/)

# Ubiquiti Unifi SDN Controller

The UniFi Controller software is a powerful, enterprise wireless software engine ideal for high-density client deployments requiring low latency and high uptime performance. This unofficial image is a minimalist re-packaging of the upstream binaries into an Alpine Linux based container. The image has been adapted to better fit the Docker tooling by logging everything to stdout and running with reduced privileges.

## Usage
At a minimum users should mount a data volume over `/var/lib/unifi` for storage of their databases and downloaded firmware.

A minimal run command would be:

```
docker run \
    -v /your-unifi-path:/var/lib/unifi \
    -p 8080:8080 \
    -p 8443:8443 \
    mcrute/unifi-controller:stable
```

After bootstrap the controller will run as the `unifi` user within the container. It is possible to map the unifi user id and group id within the container to a custom uid/gid using the `UNIFI_UID` and `UNIFI_GID` environment variables. The default is uid 101 and gid 102.

An example of this:

```
docker run \
    -v /your-unifi-path:/var/lib/unifi \
    -e UNIFI_UID=201 \
    -e UNIFI_GID=302 \
    -p 8080:8080 \
    -p 8443:8443 \
    mcrute/unifi-controller:stable
```

## License
View [license information](https://www.ubnt.com/eula/) for the software contained in this image.

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).

As for any pre-built image usage, 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.

## Used Software
This container builds on [Alpine Linux](http://alpinelinux.org/) and uses [su-exec](https://github.com/ncopa/su-exec) for privilege separation.