UniFi Controller

UniFi Controller is the self-hosted management server for Ubiquiti UniFi network devices, letting homelab operators adopt, configure, and monitor UniFi access…

  • Network Services
  • Other
  • Tools & Utilities
UniFi Controller is the self-hosted management server for Ubiquiti UniFi network devices, letting homelab operators adopt, configure, and monitor UniFi access points, switches, and gateways from a single dashboard. It runs the official UniFi Network application in a LinuxServer container, giving you full control over your UniFi fleet without relying on Ubiquiti's cloud services.

Platform availability

Available on 4 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

37/100 Low

Maintained
0GitHub repository is archived
Popular
59868 GitHub stars
Easy to install
654 install platforms, install notes, Docker image
Light to run
602 GB minimum RAM, runs on ARM

Availability: platform listings confirmed today, links checked 2 days ago

GitHub stars
868
Open issues
0
Last commit
2024-01-01
Latest release
8.0.24-ls221
License
GPL-3.0
Activity
stale

Checked 17 days ago - source: GitHub (linuxserver/docker-unifi-controller)

Resources & Compatibility

Minimum requirements: 2 GB RAM, 2 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set user, time zone, and config folder In the container settings, fill in PUID/PGID (the user and group IDs the container runs as), your time zone, and a folder for /config. These prevent permission mistakes and keep the controller's settings in a safe place you can back up. source
  • Turn on automatic restart Set the container's restart setting to unless-stopped so UniFi starts again after a reboot or Docker restarts. Without it, the dashboard may stay offline until you start the container by hand. source
  • Check Docker works first Run the simple hello-world test before installing UniFi to make sure Docker is installed and working. If that test fails, the UniFi container will not start, so fix Docker first. source
  • Set controller hostname/IP for device adoption To adopt a device such as an Access Point, set Settings > System Settings > Controller Configuration > Controller Hostname/IP to a hostname or IP address your devices can reach, and enable "Override inform host with controller hostname/IP" so devices can contact the controller's inform endpoint during adoption. source
  • Image no longer maintained (repo archived) The docker-unifi-controller repository has been archived, so this image no longer receives updates (last commit January 2024). For ongoing updates or UNMS support, LinuxServer's published how-to covers upgrading to their newer Unifi Network Application image. source

Fetched 7 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which container settings should I configure to avoid permission issues and keep UniFi settings backed up?

Set PUID/PGID, your time zone, and a folder for /config in the container settings. These keep the controller's settings in a safe place you can back up.

How do I make the UniFi container start automatically after reboots?

Set the container restart setting to unless-stopped. This makes UniFi start again after a host reboot or Docker restart.

How do I move from the deprecated linuxserver.io unifi-controller container?

Use the upgrade path to the newer linuxserver.io unifi-network-application container. The post covers migrating an existing Docker setup.

Is a self-hosted UniFi controller the same as the controller on Ubiquiti hardware?

It is the same as the hardware controller, minus a few options because of hardware differences.

Answers sourced from github.com, github.com, www.reddit.com, www.reddit.com

Community

Collected 48 days ago - public community threads