Skip to main content


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


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.


  1. Install Homebrew
    /usr/bin/ruby -e "$(curl -fsSL"
  2. Install Poller
    brew install golift/mugs/unpoller
  3. Edit the config file after installing the brew.

    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


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.