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

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# 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](/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 Debian
3. Navigate to the [latest release](https://github.com/grafana/alloy/releases/latest) 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 code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```shell
      sudo dpkg -i alloy-*.deb
      ```
   
   ### RHEL, CentOS, and Fedora
4. Navigate to the [latest release](https://github.com/grafana/alloy/releases/latest) 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 code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```shell
      sudo rpm -i alloy-*.rpm
      ```
   
   ### macOS

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
   ```

### Docker

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
   ```
   
   1. 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"
      }
      ```
   2. 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
      ```
   
   ### Windows
2. Navigate to the [latest release](https://github.com/grafana/alloy/releases/latest) 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 code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```sh
   sudo systemctl start alloy
   ```
   
   1. Verify Alloy is running:
      
      sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
      
      ```sh
      sudo systemctl status alloy
      ```
   
   ### macOS
3. Start Alloy:
   
   sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```sh
   brew services start grafana/grafana/alloy
   ```
   
   1. 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
      ```
   
   ### 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`](http://localhost:12345) and make sure the Alloy UI loads without error.

Watch video -&gt;