---
title: Install the agent with MSI installer
source: https://docs.newrelic.com/docs/infrastructure/infrastructure-agent/windows-installation/windows-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](https://docs.newrelic.com/docs/infrastructure/install-infrastructure-agent/get-started/requirements-infrastructure-agent) Windows Server and Windows 10 and 11. You can also [install with Chef](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/config-management-tools/configure-new-relic-infrastructure-using-chef). Before installation, be sure to review the [requirements](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/getting-started/compatibility-requirements-new-relic-infrastructurets).

## Install for Windows using our guided install [#install-windows]

[Create a New Relic account](https://newrelic.com/signup) for free! No credit card required.

[Get an account](https://newrelic.com/signup)

[Guided install](https://one.newrelic.com/marketplace/install-data-source?state=fbe85f19-a04c-7a2b-0765-3a96ab418be6)

## Manual installation [#install-manual]

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

1.  Review the [agent requirements and supported operating systems](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/getting-started/compatibility-requirements-new-relic-infrastructure).

2.  Download the latest .MSI installer image from:

    -   For 64-bit Windows (Intel/AMD):
        ```
        <a href="https://download.newrelic.com/infrastructure_agent/windows/newrelic-infra.msi">https://download.newrelic.com/infrastructure_agent/windows/newrelic-infra.msi</a>
        ```

    > #### ⚠️ 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:
        ```shell
        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:

        ```shell
        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](https://docs.newrelic.com/docs/infrastructure/install-infrastructure-agent/configuration/configure-infrastructure-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:

    ```yml
    license_key: YOUR_LICENSE_KEY
    ```

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

Wait a few minutes, then [view your server in the infrastructure UI](https://docs.newrelic.com/docs/infrastructure/infrastructure-ui-pages/infra-ui-overview). If no data appears after waiting a few minutes, follow these troubleshooting pages:

-   [No data appears in the infrastructure UI](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/troubleshooting/no-data-appears-infrastructure)
-   [Windows MSI installation fails with error 1603](https://docs.newrelic.com/docs/infrastructure/infrastructure-troubleshooting/troubleshoot-infrastructure/windows-msi-install-fails-error-1603)

## Install using zip files [#install-zip]

For custom setup scenarios, you can install the infrastructure agent using [our zip files](https://download.newrelic.com/infrastructure_agent/binaries/windows/) in [assisted](https://docs.newrelic.com/docs/infrastructure/install-configure-infrastructure/windows-installation/assisted-install-infrastructure-windows) or [manual](https://docs.newrelic.com/docs/infrastructure/install-configure-infrastructure/windows-installation/manual-install-infrastructure-windows) modes. This is especially useful when you need to adapt the default installation settings to your environment.

> #### ⚠️ CAUTION
>
> Installing the infrastructure agent using zip files isn't supported.

## What's next? [#configure]

The only required [configuration option](https://docs.newrelic.com/docs/infrastructure/install-configure-infrastructure/configuration/configure-infrastructure-agent) is the [`license_key`](https://docs.newrelic.com/docs/infrastructure-configure-your-agent#conf-license_key) setting, which is created as part of the installation procedures. You may also want to:

-   [Learn to use your host data](https://docs.newrelic.com/docs/tutorial-troubleshoot-infra-hosts/diagnose-app-infra-data) to troubleshoot an alert event.
-   [Add custom attributes](https://docs.newrelic.com/docs/Infrastructure-configure-your-agent#conf-custom_attributes) to annotate your infrastructure data.
-   [Connect your AWS account](https://docs.newrelic.com/docs/infrastructure-amazon-aws-ec2-integration#connect) if your servers are hosted on Amazon EC2.
-   Enable [log forwarding](https://docs.newrelic.com/docs/logs/enable-new-relic-logs/1-enable-logs/forward-your-logs-using-new-relic-infrastructure-agent).
-   Add other [New Relic infrastructure integrations](https://docs.newrelic.com/docs/infrastructure/introduction-infra-monitoring) to collect data from external services.

## Update the agent [#update]

To upgrade to the latest version, follow standard procedures to [update the infrastructure agent](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/installation/update-infrastructure-agent).