• Log in

Install the infrastructure monitoring agent for Linux

The quickest way to get started with our infrastructure monitoring agent is through our guided install. If you're in the EU, try our EU guided install. Either way, you'll need a New Relic account if you don't have one. You can create a one for free, forever.

Get an account

Step-by-step instructions

If guided install doesn't work, you can install the agent manually. Before installing infrastructure, be sure to:

To install infrastructure in Linux, follow these instructions:

  1. Create the configuration file and add your license key:

    echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /etc/newrelic-infra.yml
  2. Determine the distribution version number:

  3. Enable New Relic's GPG key:

  4. Add the infrastructure monitoring agent repository:

  5. Refresh the repositories:

  6. Install the newrelic-infra package in root (default), privileged user, or unprivileged user mode. For more information on each running mode, see Linux agent running modes.

Once the infrastructure monitoring agent is installed or updated, you can start, stop, or check the agent status.


As of version 1.4.0, the infrastructure monitoring agent package includes the additional newrelic-infra-ctl binary, which is used to help troubleshoot a running agent. Although this binary is not required to execute the agent, we recommend to add it in your path.

Install using configuration management tools

To install the infrastructure monitoring agent with a configuration management tool, see the documentation for:

Install for Docker containers on instrumented hosts

See Docker instrumentation for infrastructure monitoring.

Install using Azure extensions

See Azure extensions for infrastructure monitoring.

Install using tarball files

For custom setup scenarios, you can install the infrastructure monitoring agent using our tarball files in assisted or manual modes.

This is especially useful when you need to adapt the default installation settings to your environment, or to install the infrastructure monitoring agent on distributions that lack the newrelic-infra package in their repositories.


Note that custom installation of the infrastructure agent using tarball files is not officially supported.

Update the agent

Follow standard procedures to update the infrastructure monitoring agent.

If you are using sudo to install or update the agent, use the -E argument to allow bypassing the environment variables, or specify the NRIA_MODE environment variable just after sudo.




What's next?

Generate some traffic and wait a few minutes, then view your hosts in the New Relic UI. If necessary, follow our troubleshooting procedures if no data appears.


The hostname for your server cannot be localhost. Data will not be reported for servers with that name. Make sure the host name uses a unique name.

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

Copyright © 2022 New Relic Inc.

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