NOTE: New Relic Servers and Legacy Alerts are going away on or before May 15, 2018. Check out our post in the Online Technical Community for more information.

Install with yum or apt

Deprecated

For the latest, most advanced host monitoring, check out New Relic Infrastructure.

To install Infrastructure on your Linux system, see Install Infrastructure for Linux.

Servers for Linux does not require root access to run. However, the agent typically requires root access to install, because the install scripts write to protected directories and interact with the system package databases. If you want to install as a non-root user, follow the instructions for tarball installation.

Install with apt (Debian and Ubuntu)

To install Infrastructure on Debian or Ubuntu, see Install Infrastructure for Linux.

Run the commands in this procedure as root:

Step Notes
1.

Configure the New Relic apt repository.

echo 'deb http://apt.newrelic.com/debian/ newrelic non-free' | sudo tee /etc/apt/sources.list.d/newrelic.list

This command adds deb http://apt.newrelic.com/debian/ newrelic non-free to /etc/apt/sources.list.d/newrelic.list. It creates the file if it does not exist.
This step only needs to be done once on each system.

2.

Trust the New Relic GPG key.

This step is required to register New Relic as an authenticated source where apt-get will look for new packages. To get the New Relic public apt-key from global key servers, run the following command as root:

wget -O- https://download.newrelic.com/548C16BF.gpg | apt-key add -

Note: If you do not run this command as root, you may see an error message about the public key. If this occurs, include sudo in the command:

wget -O- https://download.newrelic.com/548C16BF.gpg | sudo apt-key add -
3.

Update the local package list.

Execute the following command as root:

apt-get update
4.

Install Servers for Linux.

Execute the following command as root:

apt-get install newrelic-sysmond

If you see a warning about your license key at this point, you may ignore it.

5.

Configure your New Relic license key.

Your license key appears in the Account Information section of your New Relic Account settings. Execute the following command as root. (This step only needs to be done once on each system.)

nrsysmond-config --set license_key=YOUR_LICENSE_KEY

Optional: You can set the license_key configuration setting directly in /etc/newrelic/nrsysmond.cfg instead.

6.

Start nrsysmond.

Execute the startup command as root:

  • If you use systemd (common in Ubuntu 15.04 and higher or Debian 8 and higher), use:

    systemctl start newrelic-sysmond
  • If you use init.d (older versions of Ubuntu and Debian), use:

    /etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully.

7.

Optional: Enable Docker.

Then, view your server in the New Relic UI: Go to rpm.newrelic.com/servers > (select your server).

Install with yum (CentOS and RedHat)

To install Infrastructure on Amazon LInux, CentOS, or RedHat; see Install Infrastructure for Linux.

Run the commands in this procedure as root:

Step Notes
1.

Configure the Servers for Linux yum repository.

Tell rpm about the New Relic repository by running one of the following commands as root. (This step only needs to be done once on each system.)

32-bit:

rpm -Uvh https://yum.newrelic.com/pub/newrelic/el5/i386/newrelic-repo-5-3.noarch.rpm

64-bit:

rpm -Uvh https://yum.newrelic.com/pub/newrelic/el5/x86_64/newrelic-repo-5-3.noarch.rpm
2.

Install Servers for Linux.

Execute the following command as root:

yum install newrelic-sysmond

If you see a warning about your license key at this point, ignore it.

3.

Configure your New Relic license key.

Your license key appears in the Account Information section of your New Relic Account settings. Execute the following command as root. (This step only needs to be done once on each system.)

nrsysmond-config --set license_key=YOUR_LICENSE_KEY

Optional: You can set the license_key configuration setting directly in /etc/newrelic/nrsysmond.cfg instead.

4.

Start nrsysmond.

Execute the following command as root:

/etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully, or refer to the troubleshooting instructions.

5.

Optional: Enable Docker.

Then, view your server in the New Relic UI: Go to rpm.newrelic.com/servers > (select your server).

Manual installation

If you need to install Servers for Linux without using a package manager, follow the appropriate directions for your platform:

Using dpkg

If you use this method, you will need to manually install updates. That is why the apt solution described above is the preferred method for Servers for Linux installation and maintenance.

Step Notes
1.

Copy the URL for the package download.

Navigate to the appropriate URL for your architecture and copy the full URL for the latest newrelic-sysmond package:

2.

Download the package.

Run the following wget command, replacing https://LINK_TO_PACKAGE with the full URL of the package:

wget -L https://LINK_TO_PACKAGE
3.

Install Servers for Linux.

Run the appropriate command as root, replacing X.X.X.X with the current version:

32-bit:

dpkg -i newrelic-sysmond_X.X.X.X_i386.deb

64-bit:

dpkg -i newrelic-sysmond_X.X.X.X_amd64.deb
4.

Configure your New Relic license key.

Your license key appears in the Account Information section of your New Relic Account settings. Execute the following command as root. (This step only needs to be done once on each system.)

nrsysmond-config --set license_key=YOUR_LICENSE_KEY

Optional: You can set the license_key configuration setting directly in /etc/newrelic/nrsysmond.cfg instead.

5.

Start nrsysmond.

Execute the startup command as root:

  • If you use systemd (common in Ubuntu 15.04 and higher or Debian 8 and higher), use:

    systemctl start newrelic-sysmond
  • If you use init.d (older versions of Ubuntu and Debian), use:

    /etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully.

6.

Optional: Enable Docker.

Then, view your server in the New Relic UI: Go to rpm.newrelic.com/servers > (select your server).

Using rpm
Step Notes
1.

Copy the URL for the package download.

Navigate to the appropriate URL for your architecture and copy the URL for the latest newrelic-sysmond package:

2.

Download the package.

Run the following wget command, replacing https://LINK_TO_PACKAGE with the full URL of the package:

wget -L https://LINK_TO_PACKAGE
3.

Install Servers for Linux.

Run the appropriate command as root, replacing X.X.X.X with the current version:

32-bit:

rpm -i newrelic-sysmond-X.X.X.X-1.i386.rpm

64-bit:

rpm -i newrelic-sysmond-X.X.X.X-1.x86_64.rpm
4.

Configure your New Relic license key.

Your license key appears in the Account Information section of your New Relic Account settings. Execute the following command as root. (This step only needs to be done once on each system.)

nrsysmond-config --set license_key=YOUR_LICENSE_KEY

Optional: You can set the license_key configuration setting directly in /etc/newrelic/nrsysmond.cfg instead.

5.

Start nrsysmond.

Execute the following command as root:

/etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully, or refer to the troubleshooting instructions.

6.

Optional: Enable Docker.

Then, view your server in the New Relic UI: Go to rpm.newrelic.com/servers > (select your server).

Using the tarball

If the other options do not work with your server configuration, you can install from the binary tarball. See Servers installation: Other Linux.

Uninstalling

To uninstall Servers for Linux:

  1. Execute one of the following commands as root:

    • If using apt: apt-get remove newrelic-sysmond
    • If using dpkg: dpkg -r newrelic-sysmond
    • If using yum: yum remove newrelic-sysmond
    • If using rpm: rpm -ev newrelic-sysmond
  2. When the uninstall process finishes, wait a few minutes and then verify that no data is being reported for that server in New Relic Servers.

For more help

Additional documentation resources include:

Discuss New Relic Servers in the New Relic Online Technical Community! Troubleshoot and ask questions, or discuss Servers for Linux or Servers for Windows in detail.

If you need additional help, get support at support.newrelic.com.