newrelic-install script simplifies installing PHP applications in New Relic. It works with multiple PHP installations as well as installations in non-standard locations. Running it will:
- Copy the correct PHP modules into place.
- Install sample
- Configure the New Relic proxy daemon.
Be sure to review the information about working with multiple installations and non-standard locations before running the script.
The installer script location depends on how you installed the New Relic PHP agent.
- Via system package manager: The installation script is in the
- Via a tarball: The installation script is in the directory where you extracted the
tararchive file. The script in the
tardistribution includes installation steps otherwise handled by the package manager.
newrelic-install to correctly detect multiple installations, ensure your
PATH environment variable is correctly set. The
newrelic-install script can only install the agent for versions it can find.
If you want to...
Specify additional directories
Specify a set of directories in the
From the command line, run the script at its location:
- Via system package manager:
- Via a
Follow this process to install New Relic.
To install the daemon without the agent, use PHP agent 9.2 or higher. Run
newrelic-install with the
install_daemon command line option.
This is useful if the daemon runs on a different host or in a different container than the PHP application. For example, this may happen with agent install on containers.
If there were problems with the installation process, or if no data appears in the UI, review the PHP troubleshooting procedures before contacting New Relic for support. Be sure to attach your archive file to any bug report, as well as the output of the
phpinfo() function produced by your web server.
You can uninstall New Relic but keep valuable config files (useful when upgrading), or permanently uninstall New Relic from your system.
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.