Your data. Anywhere you go.

New Relic for iOS or Android

Download on the App Store    Android App on Google play

New Relic Insights App for iOS

Download on the App Store

Learn more

Close icon

Relic Solution: PHP Agent Manual Install


The New Relic PHP Agent installer attempts to automatically detect your PHP installations and add the correct files to the correct locations for each. But with PHP, non-standard installations can be standard and sometimes the installer can’t figure out all the unique ways PHP can be configured. In these cases, a manual install may be best.

Note, you should first try running the installer with the NR_INSTALL_PATH environment variable set to a path or paths that include your PHP binaries:

If that also fails you can install the agent manually with the below steps.

Manual Installation

  1. If this is a web application, create a phpinfo() page to gather your PHP configuration. This can be different than your command line php -i
  1. Download the tarball installer from and unpack it.
  1. Find your PHP “extension_dir”. This will be where to copy the

  2. Find your PHP Extension number. This will determine the version of the to copy and look like 20151012 or some other date.

  3. Make a note if Thread Safety is enabled or disabled.

  4. Copy the if Thread Safety is disabled or if Thread Safety is enabled to your extension_dir. Something like this:

cp newrelic-php5-*-linux/agent/x64/ /usr/lib64/php/modules/

  1. Find your “Additional ini directory” in your phpinfo

  2. Copy the the newrelic.ini.template to your Additional ini directory. Something like this:

cp newrelic-php5-*-linux/scripts/newrelic.ini.template /etc/php.d/newrelic.ini

  1. Edit the newrelic.ini you’ve created to add your license key and appname

  2. Copy the daemon to the default daemon location:

cp newrelic-php5-*-linux/daemon/newrelic-daemon.x64 /usr/bin/
mv /usr/bin/newrelic-daemon.x64 /usr/bin/newrelic-daemon

That’s it! Your manual install is complete.

Why package newrelic-php5 depends on python