Install the infrastructure monitoring agent for Linux
Our infrastructure monitoring agent for Linux can be installed using several package managers. You can use our launcher, or follow the instructions in this document to complete a basic installation.
No matter which installation option you choose, make sure you've created a free New Relic account (No credit card required).
Quick start
The quickest way to get started with our infrastructure monitoring agent is through our guided install.
There's a known issue with the zypper package manager where GPG keys may not be validated as expected. If you get errors such as Signature verification failed, see New Relic's Explorers Hub for more information.
Add the infrastructure monitoring agent repository:
Debian 8 ("Jessie")
printf "deb https://download.newrelic.com/infrastructure_agent/linux/apt jessie main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list
Debian 9 ("Stretch")
printf "deb https://download.newrelic.com/infrastructure_agent/linux/apt stretch main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list
Debian 10 ("Buster")
printf "deb https://download.newrelic.com/infrastructure_agent/linux/apt buster main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list
Debian 11 ("Bullseye")
printf "deb https://download.newrelic.com/infrastructure_agent/linux/apt bullseye main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list
Ubuntu 16 ("Xenial")
printf "deb https://download.newrelic.com/infrastructure_agent/linux/apt xenial main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list
Ubuntu 18 ("Bionic")
printf "deb https://download.newrelic.com/infrastructure_agent/linux/apt bionic main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list
Ubuntu 20 ("Focal")
printf "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")
printf "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")
printf "deb https://download.newrelic.com/infrastructure_agent/linux/apt hirsute main" | sudo tee -a /etc/apt/sources.list.d/newrelic-infra.list
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.
Debian and Ubuntu:
sudo apt-get install newrelic-infra -y
Amazon Linux, CentOS, RHEL:
sudo yum install newrelic-infra -y
SLES:
sudo zypper -n install newrelic-infra
Install the libcap library and set the NRIA_MODE environment variable to PRIVILEGED.
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:
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.
Important
Installing the agent using tarball files is officially supported only for the AWS Graviton 2 processor.
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.