You can install New Relic's PHP agent from compressed tar files on any supported operating system on any supported processor architecture. However, for Redhat or CentOS on x86_64 it is more common to use the RPM package. For Ubuntu or Debian on x86_64 it is more common to use the Debian package.
Download the tar distribution
Unlike other installation options, tar archives do not require any special repository setup. All you need to do is download the archive and follow these instructions.
Download the appropriate tar distribution file from download.newrelic.com/php_agent/release/:
- For Linux with GNU libc (most Linux distributions), download
newrelic-php5-X.X.X.X-linux.tar.gz
. - For Linux with musl libc (Alpine Linux), download
newrelic-php5-X.X.X.X-linux-musl.tar.gz
.
Tip
The package name for the PHP agent is newrelic-php5
. Although the package name references PHP 5, this package works for all supported PHP versions.
Install or update
With tar file installation, the steps for first time installation and for updating are the same. Replace X.X.X.X with the correct New Relic version. To install or update the agent:
Download the appropriate tar file from the New Relic website, and save it to a local disk in a convenient location. Don't use the
/tmp
folder.Decompress and extract the archive:
bash$gzip -dc newrelic-php5-X.X.X.X-OS.tar.gz | tar xf -Change to the newly created directory:
bash$cd newrelic-php5-X.X.X.X-OSRun the installation script:
bash$./newrelic-installChange the default application name to a meaningful name.
Restart your web server (Apache, Nginx, PHP-FPM, etc.).
Wait a few minutes for your application to send data, then check your app's performance in the UI.