Install Infrastructure for Windows Server using the package manager

With Infrastructure for Windows, you can monitor not only individual servers, but understand how your service performs as a whole. The Windows agent can run on your own hardware, or in cloud systems such as Amazon EC2 or Windows Azure. Infrastructure supports Windows Server and many Linux distributions. Before installation, review the Compatibility and requirements.

Install for Windows Server

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 Infrastructure agent on Windows Server:

Do not double-click the installer. This will not fully install the local agent and can result in permissions issues.

  1. Review the agent requirements and supported operating systems.

  2. Download the latest .MSI installer image from:

    32-bit Windows
    64-bit Windows
  3. In an admin account, run the install script using an absolute path.

    32-bit Windows

    To install from the Windows command prompt, run:

    msiexec.exe /qn /i PATH\TO\newrelic-infra-386.msi
    64-bit Windows

    To install from the Windows command prompt, run:

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

    For a scripted installation, you can also pass in configuration parameters. You must first add GENERATE_CONFIG=true and LICENSE_KEY=YOUR_LICENSE_KEY. You may then add these optional config settings:


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

  4. Add your New Relic license key to the license_key attribute in newrelic-infra.yml, located in C:\Program Files\New Relic\newrelic-infra\. When finished, the contents of newrelic-infra.yml should resemble the following:

    license_key: YOUR_LICENSE_KEY
  5. Start the newrelic-infra service. To start from the Windows command prompt, run:

    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.

For more information, check out New Relic University’s tutorial Installing New Relic Infrastructure Agent on Microsoft Windows. Or, go directly to the full online course Getting started with Infrastructure.

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:

Update the agent

To upgrade to the latest version, see Update the Infrastructure agent.

For more help

Recommendations for learning more: