11notes / docker-unifi

Run a Unifi Controller based on Ubuntu. Big, heavy, mostly secure and a bit slow (thanks Canonical).

🍟 Ubuntu - unifi

Run Unifi Controller (DB included)

SYNOPSIS

What can I do with this? This image will provide you a rock solid¹ Unifi controller with included MongoDB (no separate image needed, since its EOL anyway).

VOLUMES

• /unifi/var - Directory of all configuration data and sites

RUN

docker run --name unifi \
  -v .../var:/unifi/var \
  -d 11notes/unifi:[tag]

DEFAULT SETTINGS

Parameter	Value	Description
user	docker	user docker
uid	1000	user id 1000
gid	1000	group id 1000
home	/unifi	home directory of user docker

ENVIRONMENT

Parameter	Value	Default
TZ	Time Zone
DEBUG	Show debug information

PARENT IMAGE

• ubuntu:20.04

BUILT WITH

• unifi
• ubuntu

TIPS

• Allow non-root ports < 1024 via echo "net.ipv4.ip_unprivileged_port_start=53" > /etc/sysctl.d/ports.conf
• Use a reverse proxy like Traefik, Nginx to terminate TLS with a valid certificate
• Use Let’s Encrypt certificates to protect your SSL endpoints

Disclaimers

• ¹ This image will automatically disable anonymous telemetry collected by Ubiquiti by adding a flag (config.system_cfg.1=system.analytics.anonymous=disabled) to each sites config.properties. You will still have to disable telemetry in the global settings too, to disable all telemetry. You can check your telemetry status by SSH’ing into an access point and checking grep analytics /tmp/system.cfg, the output should read disabled. Make sure to also DNS block the FQDN trace.svc.ui.com in your DNS blocker.

ElevenNotes^™️

This image is provided to you at your own risk. Always make backups before updating an image to a new version. Check the changelog for breaking changes.