Skip to main content

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

    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.