---
title: "Install Grafana Alloy | Grafana Labs"
description: "Learn how to install Grafana Alloy on your system to begin collecting and forwarding traces to Grafana Cloud."
---

# 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. Watch video ->

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](/docs/alloy/latest/set-up/install/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](https://github.com/grafana/alloy/releases).
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](/docs/alloy/latest/set-up/install/).
   
   Ubuntu and DebianRHEL, CentOS, and FedoramacOSDockerWindows
   
   Ubuntu and Debian RHEL, CentOS, and Fedora macOS Docker Windows
   
   1. Navigate to the [latest release](https://github.com/grafana/alloy/releases/latest) 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 code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```shell
      sudo dpkg -i alloy-*.deb
      ```
   
   <!--THE END-->
   
   1. Navigate to the [latest release](https://github.com/grafana/alloy/releases/latest) 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 code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```shell
      sudo rpm -i alloy-*.rpm
      ```
   
   You can install Alloy on macOS with Homebrew.
   
   1. Add the Grafana Homebrew tap:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      brew tap grafana/grafana
      ```
   2. Install Alloy:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      brew install grafana/grafana/alloy
      ```
   
   <!--THE END-->
   
   1. Pull the latest Grafana Alloy Docker image:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      docker pull grafana/alloy:latest
      ```
   2. Create and save an Alloy configuration file on your computer, for example:
      
      Alloy ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```alloy
      logging {
         level  = "info"
         format = "logfmt"
      }
      ```
   3. Run the Grafana Alloy Docker container, replacing `<CONFIG_FILE_PATH>`:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      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
      ```
   
   <!--THE END-->
   
   1. Navigate to the [latest release](https://github.com/grafana/alloy/releases/latest) 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
   
   Linux macOS Windows
   
   1. Start Alloy:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      sudo systemctl start alloy
      ```
   2. Verify Alloy is running:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      sudo systemctl status alloy
      ```
   
   <!--THE END-->
   
   1. Start Alloy:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      brew services start grafana/grafana/alloy
      ```
   2. Verify Alloy is running:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      brew services info grafana/grafana/alloy
      ```
   
   <!--THE END-->
   
   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`](http://localhost:12345) and make sure the Alloy UI loads without error.