Menu

Caution

Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.

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

DocumentationGrafana AgentFlow modeGet startedInstallWindows
Open source

Install Grafana Agent Flow on Windows

You can install Grafana Agent Flow on Windows as a standard graphical install, or as a silent install.

Standard graphical install

To do a standard graphical install of Grafana Agent Flow 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 grafana-agent-flow-installer.exe.zip.

  4. Unzip the downloaded file.

  5. Double-click on grafana-agent-installer.exe to install Grafana Agent Flow.

Grafana Agent Flow is installed into the default directory C:\Program Files\Grafana Agent Flow.

Silent install

To do a silent install of Grafana Agent Flow 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 grafana-agent-flow-installer.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.river
  • /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

Grafana Agent Flow uses the Windows Registry HKLM\Software\Grafana\Grafana Agent Flow for service configuration.

  • Arguments (Type REG_MULTI_SZ) Each value represents a binary argument for grafana-agent-flow binary.
  • Environment (Type REG_MULTI_SZ) Each value represents a environment value KEY=VALUE for grafana-agent-flow binary.

Uninstall

You can uninstall Grafana Agent Flow with Windows Remove Programs or C:\Program Files\Grafana Agent\uninstaller.exe. Uninstalling Grafana Agent Flow stops the service and removes it from disk. This includes any configuration files in the installation directory.

Grafana Agent Flow can also be silently uninstalled by running uninstall.exe /S as Administrator.

Next steps