# UniFi Poller

UniFi Poller is a self-hosted monitoring tool that collects metrics from a UniFi Controller, network devices, and connected clients, then exports them to InfluxDB or Prometheus for Grafana visualization in homelabs. It is open source and self-hosted, installable on Docker Hub, Kubernetes (Helm) and Unraid.

Canonical page: https://ourlocalhost.com/app/412/unifi-poller

## Description

UniFi Poller is a self-hosted monitoring tool that collects metrics from a UniFi Controller, network devices, and connected clients, then exports them to InfluxDB or Prometheus for Grafana visualization in homelabs.

## Platform availability

Available on 2 of 9 platforms: Unraid, Helm.

## Health score

16/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (GitHub repository is archived)
- Popular: 18 (7 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/golift/unifi-poller/
- Kubernetes (Helm): https://artifacthub.io/packages/helm/halkeye/unifi-poller
- Unraid: https://ca.unraid.net/apps/unifi-poller-09pzosv1es1y7v?q=UniFi-Poller
- GitHub: https://github.com/unifi-poller/unifi-poller
- Official website: https://unifipoller.com

## Common questions

### What installation order works well for the telemetry stack?

Install InfluxDB before UniFi-Poller, confirm data is being saved, then install Grafana.

### What do I need to enable to collect DPI data?

Enable DPI collection in the poller and in the UniFi controller configuration.

### How often does UniFi-Poller collect data in Influx mode?

It polls the UniFi controller every 30 seconds for measurements and exports the data to an Influx database.

### How does Prometheus mode work?

In Prometheus mode the poller opens a web port and accepts Prometheus polling. It converts UniFi Controller API data into Prometheus exports on the fly.

### How are plugin settings configured?

Plugin config structs are automatically unmarshaled from a config file and/or environment variables, and imported plugins are initialized on startup.

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