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.

Step-by-step instructions

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

• Review the requirements.
• Have a valid license key.

To install infrastructure in Linux, follow these instructions:

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

   bash

   Copy

   $
   echo "license_key: YOUR_LICENSE_KEY" | sudo tee -a /etc/newrelic-infra.yml

2. Determine the distribution version number:

   Debian

   bash

   Copy

   $
   cat /etc/os-release

   Ubuntu

   bash

   Copy

   $
   cat /etc/lsb-release

   Amazon Linux, CentOS, Rocky Linux, RHEL, AlmaLinux & Oracle Linux

   bash

   Copy

   $
   cat /etc/os-release

   SLES

   bash

   Copy

   $
   cat /etc/os-release | grep VERSION_ID

3. Enable New Relic's GPG key:

   Debian

   bash

   Copy

   $
   curl -fsSL https://download.newrelic.com/infrastructure_agent/gpg/newrelic-infra.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/newrelic-infra.gpg

   Ubuntu

   bash

   Copy

   $
   curl -fsSL https://download.newrelic.com/infrastructure_agent/gpg/newrelic-infra.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/newrelic-infra.gpg

   Amazon Linux, CentOS, Rocky Linux, RHEL, AlmaLinux & Oracle Linux

   yum automatically installs the GPG key using the value in gpgkey.

   SLES

   bash

   Copy

   $
   curl https://download.newrelic.com/infrastructure_agent/gpg/newrelic-infra.gpg -s | sudo gpg --import

   Important

   There's a known issue with zypper package manager where GPG keys may not be validated as expected in older SLES versions. If you get errors such as Signature verification failed, update your infrastructure agent to version 1.44.0 or higher.

4. Add the infrastructure agent repository:

   Debian

   Debian 11 ("Bullseye")

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt bullseye main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Debian 12 ("Bookworm")

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt bookworm main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Ubuntu

   Ubuntu 18.04 LTS (Bionic Beaver)

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt bionic main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Ubuntu 20.04 LTS (Focal Fossa)

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt focal main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Ubuntu 20.10 (Groovy Gorilla)

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt groovy main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Ubuntu 21.04 (Hirsute Hippo)

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt hirsute main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Ubuntu 22.04 (Jammy Jellyfish)

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt/ jammy main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Ubuntu 24.04 (Noble Numbat)

   bash

   Copy

   $
   echo "deb https://download.newrelic.com/infrastructure_agent/linux/apt/ noble main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list

   Amazon Linux

   Amazon Linux 2 (x86)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/amazonlinux/2/x86_64/newrelic-infra.repo

   Amazon Linux 2 (arm64)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/amazonlinux/2/aarch64/newrelic-infra.repo

   Amazon Linux 2023 (x86)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/amazonlinux/2023/x86_64/newrelic-infra.repo

   Amazon Linux 2023 (arm64)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/amazonlinux/2023/aarch64/newrelic-infra.repo

   CentOS / Rocky Linux / RHEL/ AlmaLinux & Oracle Linux

   CentOS, RHEL, Oracle Linux 7.x (x86)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/el/7/x86_64/newrelic-infra.repo

   CentOS RHEL, Oracle Linux 7.x (arm64)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/el/7/aarch64/newrelic-infra.repo

   CentOS, RHEL, RockyLinux, AlmaLinux, and Oracle Linux 8.x (x86)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/el/8/x86_64/newrelic-infra.repo

   CentOS, RHEL, RockyLinux, AlmaLinux, and Oracle Linux 8.x (arm64)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/el/8/aarch64/newrelic-infra.repo

   RockyLinux, AlmaLinux and RHEL 9.x (x86)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/el/9/x86_64/newrelic-infra.repo

   RockyLinux, AlmaLinux and RHEL 9.x (arm64)

   bash

   Copy

   $
   sudo curl -o /etc/yum.repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/yum/el/9/aarch64/newrelic-infra.repo

   SLES

   SLES 12.5 (x86)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/12.5/x86_64/newrelic-infra.repo

   SLES 12.5 (ARM)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/12.5/aarch64/newrelic-infra.repo

   SLES 15.2 (x86)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.2/x86_64/newrelic-infra.repo

   SLES 15.2 (ARM)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.2/aarch64/newrelic-infra.repo

   SLES 15.3 (x86)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.3/x86_64/newrelic-infra.repo

   SLES 15.3 (ARM)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.3/aarch64/newrelic-infra.repo

   SLES 15.4 (x86)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.4/x86_64/newrelic-infra.repo

   SLES 15.4 (ARM)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.4/aarch64/newrelic-infra.repo

   SLES 15.4 (x86)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.5/x86_64/newrelic-infra.repo

   SLES 15.4 (ARM)

   bash

   Copy

   $
   sudo curl -o /etc/zypp/repos.d/newrelic-infra.repo https://download.newrelic.com/infrastructure_agent/linux/zypp/sles/15.5/aarch64/newrelic-infra.repo

5. Refresh the repositories:

   Debian

   bash

   Copy

   $
   sudo apt-get update

   Ubuntu

   bash

   Copy

   $
   sudo apt-get update

   Amazon Linux, CentOS, Rocky Linux, RHEL, AlmaLinux & Oracle Linux

   bash

   Copy

   $
   sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'

   SLES

   bash

   Copy

   $
   sudo zypper -n ref -r newrelic-infra

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.

   Root (default)

   • Debian and Ubuntu:

     bash

     Copy

     $
     sudo apt-get install newrelic-infra -y

   • Amazon Linux, CentOS, Rocky Linux, RHEL, AlmaLinux & Oracle Linux:

     bash

     Copy

     $
     sudo yum install newrelic-infra -y

   • SLES:

     bash

     Copy

     $
     sudo zypper -n install newrelic-infra

   Privileged user

   Install the libcap library and set the NRIA_MODE environment variable to PRIVILEGED.

   • Debian and Ubuntu:

     bash

     Copy

     $
     sudo apt-get install libcap2-bin

     bash

     Copy

     $
     sudo NRIA_MODE="PRIVILEGED" apt-get install newrelic-infra

   • Amazon Linux, CentOS, Rocky Linux, RHEL, AlmaLinux & Oracle Linux:

     bash

     Copy

     $
     sudo yum install libcap

     bash

     Copy

     $
     sudo NRIA_MODE="PRIVILEGED" yum install newrelic-infra

   • SLES:

     bash

     Copy

     $
     sudo zypper install libcap-progs

     bash

     Copy

     $
     sudo NRIA_MODE="PRIVILEGED" zypper install newrelic-infra

   Unprivileged user

   Install the libcap library and set the NRIA_MODE environment variable to UNPRIVILEGED.

   • Debian and Ubuntu:

     bash

     Copy

     $
     sudo apt-get install libcap2-bin

     bash

     Copy

     $
     sudo NRIA_MODE="UNPRIVILEGED" apt-get install newrelic-infra

   • Amazon Linux, CentOS, Rocky Linux, RHEL, AlmaLinux & Oracle Linux:

     bash

     Copy

     $
     sudo yum install libcap

     bash

     Copy

     $
     sudo NRIA_MODE="UNPRIVILEGED" yum install newrelic-infra

   • SLES:

     bash

     Copy

     $
     sudo zypper install libcap-progs

     bash

     Copy

     $
     sudo NRIA_MODE="UNPRIVILEGED" zypper install newrelic-infra

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.

$
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.

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

• Learn to use your host data to troubleshoot an incident.
• Add custom attributes to annotate your infrastructure data.
• Connect your AWS account if your servers are hosted on Amazon EC2.
• Enable log forwarding.
• Add other New Relic infrastructure integrations to collect data from external services.