Choose your infrastructure agent install method

The infrastructure agent is an executable file that collects data about your hosts. You can enable the infrastructure agent to report data from some third party services and to collect log data as well.

The infrastructure agent can run on Windows, macOS, and many Linux distributions. This document describes the different methods you can use to install the infrastructure agent. To get started, you'll need a New Relic account and a license key.

Install the infrastructure agent manually

We recommend following our manual install procedures if you're looking to monitor a couple hosts, but nothing more complex. In general, you'll use the command line to create a directory where the agent lives in, then add your license key information. Depending on your operating system, you may need to create and edit a config file as well. To install manually, start here:

Install on Linux systems with a package manager
Install on macOS
Install on Windows with MSI install, zip install, or manual zip install

Deploy the infrastructure agent programmatically

You can deploy the infrastructure agent programmatically with several config management and deploy tools:

Ansible
Chef
Docker (install as container)
Elastic Beanstalk
Puppet

Use the guided install

The guided install is a single CLI command you can run to monitor your instance. It's a good option for small organizations, or for anyone who wants to test out New Relic. When you run the CLI command, New Relic will inspect your system to find other compatibilty technologies that you may want to monitor. You'll also receive the infrastructure status API by default.

Important

The New Relic CLI does not support FedRAMP servers. If you're a FedRAMP customer, please refer to the manual installation instructions.

Choose your New Relic data center region to get started:

Guided install for US region

Guided install for EU region

What's next?

After you've installed the infrastructure agent: