# UniFi Controller

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 is open source and self-hosted, installable on Kubernetes (Helm), Docker Hub, TrueNAS and Unraid.

Canonical page: https://ourlocalhost.com/app/3805/unifi-controller

## Description

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, ZimaOS, Helm.

## Health score

37/100 (Low), based on 4 of 4 factors.
- Maintained: 0 (GitHub repository is archived)
- Popular: 59 (868 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Light to run: 60 (2 GB minimum RAM, runs on ARM)

## Links

- Kubernetes (Helm): https://artifacthub.io/packages/helm/qonstrukt/unifi-controller
- Docker Hub: https://hub.docker.com/r/linuxserver/unifi-controller
- GitHub: https://github.com/linuxserver/docker-unifi-controller
- TrueNAS: https://apps.truenas.com/catalog/unifi-controller/
- Unraid: https://ca.unraid.net/apps/unifi-controller-1ogp4pk12sv8jg?q=unifi-controller
- Documentation: https://info.linuxserver.io

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

---
Source: Our Local Host (https://ourlocalhost.com/app/3805/unifi-controller), the self-hosted and open-source app directory.
