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.