Zip assisted install of the infrastructure agent for Windows

With the assisted install of the infrastructure agent for Windows, you can make the changes you need to the installation script we provide so you can adapt it to your environment. Before installation, make sure to check the compatibility and requirements.

Install the agent

As of version 1.4.0, the infrastructure agent package includes the additional newrelic-infra-ctl binary, which is used to help troubleshoot a running agent. Although this binary is not required to execute the agent, we recommend to add it in your path. See our docs for more information.

To install the agent:

  1. Download the packaged agent file.

  2. Unpack the file.
  3. Make sure the file unpacks with the following structure:

  4. Once it's unpacked, access and edit the installation PowerShell script installer.ps1.

  5. Update your license key.
  6. Optional: Update any other parameters.
  7. Execute installer.ps1 with admin rights.

Configure your installation

You can configure the following parameters during the assisted install for Windows:

Variable Description


Required at agent startup.

The agent home directory.


C:\Program Files\New Relic\newrelic-infra


This configures the data directory to store inventory and other agent files.


C:\%ProgramData%\New Relic\newrelic-infra


Required at installation.

The agent configuration file's location.


C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml


Only configuration option required at startup.

The New Relic license key.


Required at agent startup.

The location where the agent will log.


C:\Program Files\New Relic\newrelic-infra\newrelic-infra.log 


By default and for security reasons, Windows does not install a service if there's another service with the same name already installed. To bypass this check, make sure this setting NRIA_OVERWRITE is TRUE.




Required at agent startup.

The directory containing the configuration files of the integrations.


C:\Program Files\NewRelic\newrelic-infra\inregrations.d


This provides the name for the Windows service.

What's next?

You may also want to:

For more help

If you need more help, check out these support and learning resources: