Netdata works on macOS, albeit with some limitations. The number of charts displaying system metrics is limited, but you can use any of Netdata's external plugins to monitor any services you might have installed on your macOS system. You could also use a macOS system as the parent node in a streaming configuration.
We recommend you to install Netdata with the our automatic one-line installation script,
As an alternative you also have community-created and -maintained Homebrew package.
Being community-created and -maintained we don't guarantee that the features made available on our installation script will also be available or give support to it.
To install Netdata using our automatic kickstart script you will just need to run:
With this script, you are also able to connect your nodes directly to Netdata Cloud if you wish, see more details on Connect an agent running in macOS
If you don't have Homebrew installed already, begin with their installation script:
Next, you can use Homebrew's package, which installs Netdata all its dependencies in a single step:
Homebrew will place your Netdata configuration directory at
/usr/local/etc/netdata/. Use the
edit-configscript and the files in this directory to configure Netdata. For reference, you can find stock configuration files at
Skip on ahead to the What's next? section to find links to helpful post-installation guides.
We don't recommend installing Netdata from source on macOS, as it can be difficult to configure and install dependencies manually.
First open your terminal of choice and install the Xcode development packages.
Click Install on the Software Update popup window that appears. Then, use the same terminal session to use Homebrew
to install some of Netdata's prerequisites. You can omit
cmake in case you do not want to use
Next, download Netdata from our GitHub repository:
cd into the newly-created directory and then start the installer script:
Your Netdata configuration directory will be at
/usr/local/netdata/, and your stock configuration directory will be at
The installer will also install a startup plist to start Netdata when your macOS system boots.
Or, skip straight to configuring the Netdata Agent.
Read through Netdata's documentation, which is structured based on actions and solutions, to enable features like health monitoring, alarm notifications, long-term metrics storage, exporting to external databases, and more.