UniFi Network Monitoring Stack

Docker Compose stack for monitoring UniFi networks with UnPoller, Prometheus, and Grafana.

Quick Start

1. Clone and configure

   git clone https://github.com/timothystewart6/unpoller-unifi.git   
   cd unpoller-UniFi
   

2. Edit UniFi credentials

   Update unpoller/.env with your controller details, it's advised to create a dedicated local UniFi account that has read only access to your Network controller:

    UP_UniFi_CONTROLLER_0_URL=https://192.168.10.1
    UP_UniFi_CONTROLLER_0_USER=unpoller
    UP_UniFi_CONTROLLER_0_PASS=password123
    UP_UniFi_CONTROLLER_0_SITE=default
   

   Update Grafana admin credentials in grafana/.env:

   GF_SECURITY_ADMIN_USER=admin
   GF_SECURITY_ADMIN_PASSWORD=admin123
   

   Optionally update timezone in dozzle/.env, grafana/.env, prometheus/.env, unpoller/.env:

   TZ=Your/Timezone
   

3. Start the stack

   docker-compose up -d
   

Access

Grafana default login: admin/admin123 (change in grafana/.env)

What's Included

• Pre-configured environment files for all services
• Grafana dashboards for UniFi devices (Access Points, Switches, Gateway, Clients, DPI, Sites, PDU)
• Prometheus data source auto-provisioned
• Log viewer with Dozzle

Resources

• 📖 Detailed Guide: UniFi Observability with UnPoller, Prometheus, and Grafana
• 🎥 Video Tutorial: UniFi Observability Done Right (Unpoller + Grafana Walkthrough)

Troubleshooting

• Check logs: docker-compose logs [service-name] or use Dozzle at http://localhost:8080
• Verify UniFi controller accessibility from Docker network
• Ensure a local UniFi account has been created with read-only/view-only network controller access
• For 429 errors, increase scrape interval in prometheus/config/prometheus.yml

Acknowledgments

This stack is built using these excellent open-source projects:

• UnPoller - Polls UniFi controllers for device and client metrics
• Prometheus - Systems monitoring and alerting toolkit
• Grafana - Open source analytics and interactive visualization web application
• Dozzle - Real-time log viewer for Docker containers

Special thanks to the maintainers and contributors of these projects for making UniFi network monitoring accessible and powerful.