Install Grafana Alloy on Windows

This is documentation for the next version of Alloy. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana Alloybreadcrumb arrow Set upbreadcrumb arrow Installbreadcrumb arrow Windows
Open source

Install Grafana Alloy on Windows

You can install Alloy on Windows as a standard graphical install, or as a silent install.

Standard graphical install

To do a standard graphical install of Alloy on Windows, perform the following steps.

  1. Navigate to the latest release on GitHub.

  2. Scroll down to the Assets section.

  3. Download the file called alloy-installer-windows-amd64.exe.zip.

  4. Extract the downloaded file.

  5. Double-click on alloy-installer-windows-amd64.exe to install Alloy.

Alloy is installed into the default directory %PROGRAMFILES64%\GrafanaLabs\Alloy.

Silent install

To do a silent install of Alloy on Windows, perform the following steps.

  1. Navigate to the latest release on GitHub.

  2. Scroll down to the Assets section.

  3. Download the file called alloy-installer-windows-amd64.exe.zip.

  4. Extract the downloaded file.

  5. Run the following command in PowerShell or Command Prompt:

    cmd 
    <PATH_TO_INSTALLER> /S

    Replace the following:

    • <PATH_TO_INSTALLER>: The path to the uncompressed installer executable.

Silent install options

  • /CONFIG=<path> Path to the configuration file. Default: $INSTDIR\config.alloy
  • /DISABLEREPORTING=<yes|no> Disable data collection. Default: no
  • /DISABLEPROFILING=<yes|no> Disable profiling endpoint. Default: no
  • /ENVIRONMENT="KEY=VALUE\0KEY2=VALUE2" Define environment variables for Windows Service. Default: ``
  • /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="<username>" Set the fully qualified user that Windows will use to run the service. Default: NT AUTHORITY\LocalSystem
  • /PASSWORD="<password>" Set the password of the user that Windows will use to run the service. This is not required for standard Windows Service Accounts like LocalSystem. Default: ``

Note

The --windows.priority flag is in Public preview and is not covered by Grafana Alloy backward compatibility guarantees. The /RUNTIMEPRIORITY installation option sets this flag, and if Alloy is not running with an appropriate stability level it will fail to start.

Service Configuration

Alloy uses the Windows Registry HKLM\Software\GrafanaLabs\Alloy for service configuration.

  • Arguments (Type REG_MULTI_SZ) Each value represents a binary argument for alloy binary.
  • Environment (Type REG_MULTI_SZ) Each value represents a environment value KEY=VALUE for alloy binary.

Uninstall

You can uninstall Alloy with Windows Remove Programs or %PROGRAMFILES64%\GrafanaLabs\Alloy\uninstaller.exe. Uninstalling Alloy stops the service and removes it from disk. This includes any configuration files in the installation directory.

Alloy can also be silently uninstalled by running uninstall.exe /S as Administrator.

Next steps