Installation Overview
Installation Overview
If you prefer you can keep this page open as you walk through the installation steps of the UnPoller suite.
The UnPoller suite allows you to collect data from your UniFi network controller, save it to a database, and then display it on pre-supplied attractive and data-rich Grafana dashboards.
The suite consists of three main programs that work together:
UnPoller itself --> The Database --> Grafana viewer dashboards
For more information check out how it works. If you're ready to get started, follow our step by step install guide below.
1) Choose an Installation Method
2) Setup UniFi login for UnPoller
No matter which method of installation you choose you will need to give UnPoller a way to access the information in your controller. You can set up UnPoller to get information from multiple controllers if you want, however we recommend getting one controller working before linking multiple.
3) Create Config
The config tells UnPoller where to find the UniFi controller(s), database, and other information. (If you are doing a Manual installation you may need some information from Step-4 to complete the config.)
4) Install UnPoller Suite
Option 1 - Using a Docker image
Option 2 - Manual installation
Install Database: InfluxDB and Prometheus are both supported. You only need one.
InfluxDB is recommended, as it supports both metrics and logging. Prometheus can hold only metrics. Loki is made by the developers of Prometheus to hold logs. If you want both metrics and logging you will need to install Loki alongside Prometheus.
Install Grafana: Grafana Installation
Install UnPoller: Platform specific install docs:
5) Setup Grafana
You're Done!
If you're having issues:
- Check for some Common Problems
- Check the UnPoller FAQ
- If you have questions regarding Docker check out the Docker FAQ
- Contact us on Discord
- Or try this thread on the UI community.
- Alternatively, raise an issue on GitHub.
Advanced Setup and Customization
Grafana documents how to create and edit dashboards. Copy the provided UnPoller dashboards into your own folder before customizing them so you can still import updates later. See Setup Grafana for import IDs and tips.