Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current 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. Unzip 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. Unzip 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 where the unzipped installer executable is located.

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: ``

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