--- title: "Install Grafana Alloy on Windows | Grafana Alloy documentation" description: "Learn how to install Grafana Alloy on Windows" --- # Install Grafana Alloy on Windows You can install Alloy on Windows as a standard graphical install, a WinGet install, or a silent install. ## Standard graphical install To do a standard graphical install of Alloy on Windows, perform the following steps. 1. Navigate to the [releases page](https://github.com/grafana/alloy/releases) on GitHub. 2. Scroll down to the **Assets** section. 3. Download `alloy-installer-windows-amd64.exe` or download and extract `alloy-installer-windows-amd64.exe.zip`. 4. Double-click on `alloy-installer-windows-amd64.exe` to install Alloy. The installer places Alloy in the default directory `%PROGRAMFILES%\GrafanaLabs\Alloy`. ## WinGet install To install Alloy with WinGet, perform the following steps. 1. Make sure that the [WinGet package manager](https://learn.microsoft.com/windows/package-manager/winget/) is installed. 2. Run the following command. cmd powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy cmd ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```cmd winget install GrafanaLabs.Alloy ``` powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```powershell winget install GrafanaLabs.Alloy ``` ## Silent install To do a silent install of Alloy on Windows, perform the following steps. 1. Navigate to the [releases page](https://github.com/grafana/alloy/releases) on GitHub. 2. Scroll down to the **Assets** section. 3. Download `alloy-installer-windows-amd64.exe` or download and extract `alloy-installer-windows-amd64.exe.zip`. 4. Run the following command as Administrator. cmd powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy cmd ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```cmd \alloy-installer-windows-amd64.exe /S ``` powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```powershell & \alloy-installer-windows-amd64.exe /S ``` Replace the following: - *``* : The path to the uncompressed installer executable. ### Silent install options - `/CONFIG=` Path to the configuration file. Default: `$INSTDIR\config.alloy` - `/DISABLEREPORTING=` Disable [data collection](../../../data-collection/). Default: `no` - `/DISABLEPROFILING=` Disable profiling endpoint. Default: `no` - `/ENVIRONMENT="KEY=VALUE\0KEY2=VALUE2"` Define environment variables for Windows Service. Default: \`\` - `/FORCEREGISTRY=yes` At the start of installation, delete all Alloy registry keys and then run the rest of the install as normal so that install options such as `/STABILITY` and `/DISABLEREPORTING` are written fresh. By default, the installer preserves existing registry values on upgrade; use this flag to reset them and apply the options passed on the command line, and to remove any old or unused registry keys from previous versions. - `/RUNTIMEPRIORITY="normal|below_normal|above_normal|high|idle|realtime"` Set the runtime priority of the Alloy process. Default: `normal` - `/STABILITY="generally-available|public-preview|experimental"` Set the stability level of Alloy. Default: `generally-available` - `/USERNAME=""` Set the fully qualified user that Windows uses to run the service. Default: `NT AUTHORITY\LocalSystem` - `/PASSWORD=""` Set the password of the user that Windows uses to run the service. This isn’t required for standard Windows Service Accounts like LocalSystem. Default: \`\` > Note > > The `--windows.priority` flag is in [public preview](/docs/release-life-cycle/) and isn’t covered by Grafana Alloy [backward compatibility](../../../introduction/backward-compatibility/) guarantees. The `/RUNTIMEPRIORITY` installation option sets this flag, and if Alloy isn’t running with an appropriate stability level, it fails to start. ## Service configuration Alloy uses the Windows registry key `HKLM\Software\GrafanaLabs\Alloy` for service configuration. - `Arguments`: Type `REG_MULTI_SZ`. Each value represents a binary argument for the Alloy binary. - `Environment`: Type `REG_MULTI_SZ`. Each value represents an environment value `KEY=VALUE` for the Alloy binary. ## Uninstall Uninstalling Alloy stops the service and removes it from disk. This includes any configuration files in the installation directory. ### Standard graphical uninstall To uninstall Alloy, use Add or Remove Programs or run the following command as Administrator. cmd powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy cmd ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```cmd %PROGRAMFILES%\GrafanaLabs\Alloy\uninstall.exe ``` powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```powershell & ${env:PROGRAMFILES}\GrafanaLabs\Alloy\uninstall.exe ``` ### Uninstall with WinGet To uninstall Alloy with WinGet, run the following command. cmd powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy cmd ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```cmd winget uninstall GrafanaLabs.Alloy ``` powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```powershell winget uninstall GrafanaLabs.Alloy ``` ### Silent uninstall To silently uninstall Alloy, run the following command as Administrator. cmd powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy cmd ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```cmd %PROGRAMFILES%\GrafanaLabs\Alloy\uninstall.exe /S ``` powershell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```powershell & ${env:PROGRAMFILES}\GrafanaLabs\Alloy\uninstall.exe /S ``` ## Next steps - [Run Alloy](../../run/windows/) - [Configure Alloy](../../../configure/windows/)