• EnglishEspañol日本語한국어Português
  • Log inStart now

Install the infrastructure agent for macOS

With New Relic's infrastructure agent for macOS, you can monitor key performance metrics on macOS hosts. The agent can run on your own hardware or in cloud systems such as Amazon EC2.

Our infrastructure agent has compatiblity with all generally available, Apple-supported macOS versions.

Install for macOS

Before installation, you should review the requirements. Then, to install the infrastructure agent for macOS, you can use our Guided Install, or follow the instructions in this document to complete a basic installation.


The following capabilities of the infrastructure agent are not yet available on macOS:

  • Log forwarder
  • On-host integrations (including built-in integrations such as Docker and Flex)
  • Automated deployment via configuration management tools (Chef, Ansible, Puppet)

Step-by-step instructions

To install the infrastructure agent, follow the step-by-step instructions:

  1. Review the agent requirements and supported operating systems.

  2. Make sure Homebrew is installed in the system. You can check your Homebrew installation with:

    which brew

    If it's not installed, you can install it with this command (or check Homebrew up-to-date instructions):

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. Then, open the terminal and run the following command::

    brew install newrelic-infra-agent -q
  4. Start the infrastructure agent service:

    brew services start newrelic-infra-agent
  5. Create the configuration file and add your :

    Intel x86:

    sudo mkdir -p /usr/local/etc/newrelic-infra/
    echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /usr/local/etc/newrelic-infra/newrelic-infra.yml

    Apple Silicon:

    sudo mkdir -p /opt/homebrew/etc/newrelic-infra/
    echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /opt/homebrew/etc/newrelic-infra/newrelic-infra.yml

Wait a few minutes, then view your server in the infrastructure UI. If no data appears after waiting a few minutes, follow the troubleshooting steps.

Did this doc help with your installation?

What's next?

The only required configuration option is the license_key setting, which is created as part of the installation procedures. You may also want to:

Update the agent

To upgrade to the latest version, follow standard procedures to update the infrastructure agent.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.