MacOS

This page assumes that you have decided to install UniFi Poller on to an existing macOS operating system.

First

Make sure you have set up a user on your controller for UniFi Poller to poll. You must have a working (and supported) version of Grafana and at least one of InfluxDB or Prometheus. If you don't have them, follow these instructions for installing InfluxDB and Grafana.

---

Installation

1. Install Homebrew

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2. Install Poller

   brew install golift/mugs/unpoller
3. Edit the config file after installing the brew.
   important

   When configuring make sure that you do not include :8443 on the url of the controller if you are using unifios. Those are: UDM Pro, UDM, UXG, or CloudKey with recent firmware.

   See Application Configuration for more information

   nano /usr/local/etc/unpoller/up.conf
   # or
   vi /usr/local/etc/unpoller/up.conf
4. Start the service:

   # do not use sudo
   brew services start unpoller
   • The log file should show up at /usr/local/var/log/unpoller.log
   • If it does not show up, make sure your user has permissions to create the file.
5. To restart (** required after upgrade**)

   brew services restart unpoller

Maintenance

All maintenance is done with homebrew. Example commands:

# list all services brew controls.
brew services list
# restart poller.
brew services restart unpoller
# running stop will make it not run on boot.
brew services stop unpoller
# start makes it start now and on boot.
brew services start unpoller
# run starts it but will not re-start on boot.
brew services run unpoller

Next Steps

1. Don't forget the Grafana Plugins.
2. Finish Setting-up Grafana.