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 Debian

3. Navigate to the latest release on GitHub.

   1. Scroll down to the Assets section.

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

   3. Install the package:

      shell Copy

      sudo dpkg -i alloy-*.deb

   RHEL, CentOS, and Fedora

4. Navigate to the latest release on GitHub.

   1. Scroll down to the Assets section.

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

   3. Install the package:

      shell Copy

      sudo rpm -i alloy-*.rpm

   macOS

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

Docker

1. Pull the latest Grafana Alloy Docker image:

   sh Copy

   docker pull grafana/alloy:latest

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

      Alloy Copy

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

   2. 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

   Windows

2. Navigate to the latest release on GitHub.

   1. Scroll down to the Assets section.
   2. Download the file called alloy-installer-windows-amd64.exe.zip.
   3. Extract the downloaded file.
   4. 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:

   Linux

2. Start Alloy:

   sh Copy

   sudo systemctl start alloy

   1. Verify Alloy is running:

      sh Copy

      sudo systemctl status alloy

   macOS

3. Start Alloy:

   sh Copy

   brew services start grafana/grafana/alloy

   1. Verify Alloy is running:

      sh Copy

      brew services info grafana/grafana/alloy

   Windows

4. Open the Windows Services manager:

   1. Right click on the Start Menu and select Run.

   2. Type: services.msc and click OK.

   3. 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.