Install Grafana Alloy

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 FedoramacOSDockerWindows

   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

   You can install Alloy on macOS with Homebrew.

   1. Add the Grafana Homebrew tap:

      sh Copy

      brew tap grafana/grafana

   2. Install Alloy:

      sh Copy

      brew install grafana/grafana/alloy

   1. Pull the latest Grafana Alloy Docker image:

      sh Copy

      docker pull grafana/alloy:latest

   2. Create and save an Alloy configuration file on your computer, for example:

      Alloy Copy

      logging {
         level  = "info"
         format = "logfmt"
      }

   3. Run the Grafana Alloy Docker container, replacing <CONFIG_FILE_PATH>:

      sh Copy

      docker run \
         -v <CONFIG_FILE_PATH>:/etc/alloy/config.alloy \
         -p 12345:12345 \
         -p 4318:4318 \
         -p 4317:4317 \
         --name grafana-alloy \
         grafana/alloy:latest \
            run --server.http.listen-addr=0.0.0.0:12345 --storage.path=/var/lib/alloy/data \
            /etc/alloy/config.alloy

   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.

Run Alloy and verify the installation

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

1. Run Alloy and verify the service status is running, if installed as a system service:

   LinuxmacOSWindows

   1. Start Alloy:

      sh Copy

      sudo systemctl start alloy

   2. Verify Alloy is running:

      sh Copy

      sudo systemctl status alloy

   1. Start Alloy:

      sh Copy

      brew services start grafana/grafana/alloy

   2. Verify Alloy is running:

      sh Copy

      brew services info grafana/grafana/alloy

   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.

   If you are using Docker or just want an extra sanity check that Alloy is running successfully, navigate to http://localhost:12345 and make sure the Alloy UI loads without error.