UniFi Controller
UniFi Controller is the self-hosted management server for Ubiquiti UniFi network devices, letting homelab operators adopt, configure, and monitor UniFi access…
Platform availability
Available on 4 of 10 platforms
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
Variants
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
- Is it safe to self host in Docker? : r/Ubiquiti - Reddit (reddit)
- FYI for anyone using the linuxserver/unifi-controller docker ... - Reddit (reddit)
- Upgrading to linuxserver.io unifi-network-application docker (reddit)
- Howto Upgrade Unifi Controller - LinuxServer.io (forum)
- Unifi container and radius - Docker - LinuxServer.io (forum)
Collected 48 days ago - public community threads