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

Install the infrastructure agent for Linux

The quickest way to get started with our infrastructure agent is through our guided install. If you're in the EU, try our EU guided install. Either way, if you haven't already, create your free New Relic account below.

Guided install


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

Step-by-step instructions

You can install the agent manually. Before installing infrastructure, be sure to:

  • Review the requirements.
  • Have a valid .

To install infrastructure in Linux, follow these instructions:

  1. Create the configuration file and add your :

    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 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 agent is installed or updated, you can start, stop, or check the agent status.

Update the agent

Follow standard procedures to update the infrastructure 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:

Did this doc help with your installation?

Copyright © 2024 New Relic Inc.

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