---
title: "Install Grafana Alloy | Grafana Labs"
description: "Learn how to install Grafana Alloy"
---

# Install Grafana Alloy

In this milestone, you are going to use the setup guide provided by Grafana Cloud to install Alloy. Watch video ->

To install Alloy into your local machine:

1. Navigate to **Connections > Collector Setup**.
2. Click **Install Grafana Alloy**.
3. Use the following table to select the operating system.
   
   Expand table
   
   | If you are running              | Select  |
   |---------------------------------|---------|
   | Debian                          | Debian  |
   | Ubuntu                          | Debian  |
   | Red Hat Enterprise Linux (RHEL) | RedHat  |
   | Fedora                          | RedHat  |
   | CentOS                          | RedHat  |
   | Windows                         | Windows |
   | MacOS                           | MacOS   |
   
   If you are on MacOS, select the installation method.
4. Perform one of the following:
   
   Expand table
   
   If you want toThen
   
   Create a new token
   
   1. Click **Create new token**.
   2. Enter a token name.
      
      Make sure the token name is meaningful to you and something you’ll remember. For example, `prodUS`.
   3. Click **Create token.**
      
      **Note:** You don’t need to adjust the **Scopes**.
   
   Use an existing token
   
   1. Click **Use an existing token**.
   2. Enter a token you have created in the past.
   
   > **Tip:** You don’t need to copy the token. The token is added to the install Grafana Alloy script that you copy in the steps below.
5. Toggle the **Enable Remote Configuration** off.
   
   Fleet Management is not used in this learning journey.
6. In your local machine, open the Terminal.
7. In the **Install and run Grafana Alloy** section, copy the Alloy script content into the terminal and press **Enter**.
   
   > **Note:** For macOS users, the scripts are broken down so you install Alloy first, set up the Alloy configuration, and run Alloy. Make sure to execute all scripts in order.
   
   You should see a message `Successfully started alloy` in your terminal or something similar.
8. To verify that Grafana Alloy is installed correctly, navigate back to Grafana Cloud and click **Test Alloy connection**.
   
   If Grafana Alloy is installed correctly, you’ll see `Awesome! Grafana Alloy is good to go.`

In the next milestone, you’re going to learn which Alloy components to use to send system logs to Loki.

* * *

### Troubleshooting

Explore the following troubleshooting topics if you need help:

- [Common errors when executing Alloy installation script on Linux](/docs/grafana-cloud/monitor-infrastructure/integrations/troubleshoot/install-troubleshoot-linux-alloy/#common-errors-when-executing-alloy-installation-script)
- [Common errors when executing Alloy installation script on macOS](/docs/grafana-cloud/monitor-infrastructure/integrations/troubleshoot/install-troubleshoot-mac-alloy/#common-errors-when-executing-alloy-installation-script)
- [Common errors when executing Alloy installation script on Windows](/docs/grafana-cloud/monitor-infrastructure/integrations/troubleshoot/install-troubleshooting-windows-alloy/#common-errors-when-executing-alloy-installation-script)