You can install New Relic's PHP agent from compressed tar files on any supported platform. However, for Redhat or CentOS it is more common to use the RPM package. For Ubuntu or Debian it is more common to use the Debian package.
To use PHP or any other agent, as well as the rest of our observability platform, join the New Relic family! Sign up to create your free account in only a few seconds. Then ingest up to 100GB of data for free each month. Forever.
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 example:
- For FreeBSD, download
- For Alpine Linux, download
The package name for the New Relic's PHP agent is
newrelic-php5. Although the name references PHP 5, this package works for all supported PHP versions, including PHP 7 versions.
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.
Decompress and extract the archive:
gzip -dc newrelic-php5-X.X.X.X-OS.tar.gz | tar xf -
Change to the newly created directory:
Run the installation script:./newrelic-install
Change 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 New Relic UI.
If you need more help, check out these support and learning resources:
- Suggest a change and learn how to contribute to our PHP agent open source repository.
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.