Install the agent with MSI installer

With New Relic's infrastructure agent for Windows, you can monitor individual servers and also analyze how your service performs as a whole. The Windows agent can run on your hardware or in cloud systems such as Amazon EC2 or Windows Azure, and supports Windows Server and Windows 10 and 11. You can also install with Chef. Before installation, be sure to review the requirements.

Install for Windows using our guided install

Create a New Relic account for free! No credit card required.

Manual installation

If you'd like to do a manual installation, follow the next steps:

1. Review the agent requirements and supported operating systems.

2. Download the latest .MSI installer image from:

   • For 32-bit Windows:

     https://download.newrelic.com/infrastructure_agent/windows/386/newrelic-infra-386.msi​

     Copy

   • For 64-bit Windows:

     https://download.newrelic.com/infrastructure_agent/windows/newrelic-infra.msi

     Copy

   Important

   Don't double-click the installer. This won't install the local agent fully and can result in permissions issues.

3. Open PowerShell as an administrator, and run the install script using an absolute path:

   • For 32-bit Windows:

     bash

     Copy

     $
     msiexec.exe /qn /i PATH\TO\newrelic-infra-386.msi

   • For 64-bit Windows:

     bash

     Copy

     $
     msiexec.exe /qn /i PATH\TO\newrelic-infra.msi

   For a scripted installation, you can pass a limited set of agent settings as configuration parameters. You must first add GENERATE_CONFIG=true and LICENSE_KEY=YOUR_LICENSE_KEY, and then, you can add the following optional parameters::

   bash

   Copy

   $
   DISPLAY_NAME=YOUR_DISPLAY_NAME PROXY=http://YOUR_PROXY_SERVER:PROXY_PORT CUSTOM_ATTRIBUTES="{'ATTRIBUTE_1':'VALUE_1','ATTRIBUTE_2':'VALUE_2'}" METRICS_SYSTEM_SAMPLE_RATE=30 METRICS_STORAGE_SAMPLE_RATE=30 METRICS_NETWORK_SAMPLE_RATE=30 METRICS_PROCESS_SAMPLE_RATE=30 PAYLOAD_COMPRESSION_LEVEL=6

   Advanced customization is available via NRIA_ environment variables and agent configuration file, learn how to configure the agent.

   The following example sets the license key and configures a proxy server for outbound communication, as well as adding one custom attribute:

   bash

   Copy

   $
   msiexec.exe /qn /i PATH\TO\newrelic-infra.msi GENERATE_CONFIG=true LICENSE_KEY=YOUR_LICENSE_KEY PROXY=http://YOUR_PROXY_SERVER:PROXY_PORT CUSTOM_ATTRIBUTES="{'ATTRIBUTE_1':'VALUE_1'}"

4. Add your license key to the license_key attribute in your newrelic-infra.yml file, located in C:\Program Files\New Relic\newrelic-infra\. When you're finished, your newrelic-infra.yml file should look like the following:

   license_key: YOUR_LICENSE_KEY

   Copy

5. To start the newrelic-infra service, run:

   bash

   Copy

   $
   net start newrelic-infra

Wait a few minutes, then view your server in the infrastructure UI. If no data appears after waiting a few minutes, follow the troubleshooting steps.

Install using zip files

For custom setup scenarios, you can install the infrastructure agent using our zip files in assisted or manual modes. This is especially useful when you need to adapt the default installation settings to your environment.

What's next?

The only required configuration option is the license_key setting, which is created as part of the installation procedures. You may also want to:

• Learn to use your host data to troubleshoot an incident.
• Add custom attributes to annotate your infrastructure data.
• Connect your AWS account if your servers are hosted on Amazon EC2.
• Enable log forwarding.
• Add other New Relic infrastructure integrations to collect data from external services.

Update the agent

To upgrade to the latest version, follow standard procedures to update the infrastructure agent.