• Log inStart now

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

Tip

You can also get started with our infrastructure monitoring agent using configuration management tools.

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.

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.

export NRIA_MODE="SET_MODE_HERE"

OR

sudo -E YOUR_PACKAGE_MANAGER_UPDATE_COMMAND

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.

Important

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:

While you wait for your data to come in...

Did this doc help you install?

Copyright © 2022 New Relic Inc.

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