Install Grafana Alloy

In this milestone, you install Grafana Alloy on your system. Alloy is available for multiple operating systems and deployment environments, making it easy to integrate into your infrastructure.

The steps in this milestone install Alloy as a system service. You can also install Alloy as a standalone binary. Refer to Run Grafana Alloy as a standalone binary for the procedure.

To install Alloy, complete the following steps:

1. Download the appropriate Grafana Alloy package for your operating system from the Grafana Alloy releases page.

2. Install Grafana Alloy using your system’s package manager or installation method. If the method you are using isn’t listed, refer to Install Grafana Alloy.

   Ubuntu and DebianRHEL, CentOS, and FedoraDockerWindows

   1. Navigate to the latest release on GitHub.

   2. Scroll down to the Assets section.

   3. Download the DEB package file that matches your system architecture.

   4. Install the package:

      shell Copy

      sudo dpkg -i alloy-*.deb

   1. Navigate to the latest release on GitHub.

   2. Scroll down to the Assets section.

   3. Download the RPM package file that matches your system architecture.

   4. Install the package:

      shell Copy

      sudo rpm -i alloy-*.rpm

   sh Copy

   docker pull grafana/alloy:latest

   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.

Verify the installation

Alloy should run as a system service. Use these steps to confirm Alloy is installed correctly.

1. Verify the installation by checking the Alloy version:

   sh Copy

   alloy --version
   alloy, version v1.10.1 (branch: HEAD, revision: unknown)
    build user:       grafana
    build date:       2025-08-07T08:12:40Z
    go version:       go1.24.7
    platform:         darwin/arm64
    tags:             builtinassets,noebpf

2. Verify the service status, if installed as a system service:

   LinuxDockerWindows

   shell Copy

   sudo systemctl status alloy

   To verify that Alloy is running successfully, navigate to http://localhost:12345 and make sure the Alloy UI loads without error.

   1. Open the Windows Services manager:

      1. Right click on the Start Menu and select Run.
      2. Type: services.msc and click OK.

   2. Scroll down to find the Alloy service and verify that the Status is Running.

The output shows that Alloy is installed and ready for configuration.

In the next milestone, you locate your Grafana Cloud credentials. You need these credentials to configure Alloy to send traces to Grafana Cloud.