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 64-bit Windows (Intel/AMD):

     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.

   Note on v1.73.0 and above: For silent installations using the /qn switch, you must supply GENERATE_CONFIG=true and LICENSE_KEY directly in the command. Running a parameter-less silent install will fail and roll back the installation with Error 1603.

   • For 64-bit Windows:

     bash

     Copy

     $
     msiexec.exe /qn /i PATH\TO\newrelic-infra.msi GENERATE_CONFIG=true LICENSE_KEY=YOUR_LICENSE_KEY

   • For a scripted installation, you can append additional configuration parameters directly to the command:

     bash

     Copy

     $
     msiexec.exe /qn /i PATH\TO\newrelic-infra.msi GENERATE_CONFIG=true LICENSE_KEY=YOUR_LICENSE_KEY 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 the agent configuration file. Learn how to configure the agent.

4. (Optional) If you did not pass the parameters during the MSI installation step, you must manually create and 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 these troubleshooting pages:

• No data appears in the infrastructure UI
• Windows MSI installation fails with error 1603

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 alert event.
• 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.