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

# Install Grafana Alloy

The next step in your journey is to install Grafana Alloy. Alloy offers native pipelines for OTel, Prometheus, Pyroscope, Loki, and many other metrics, logs, traces, and profile tools. In addition, you can use Alloy pipelines to do different tasks, such as configure alert rules in Loki and Mimir. Alloy is fully compatible with the OTel Collector, Prometheus Agent, and Promtail.

To install Alloy you must either use an existing token or create a new one.

**Did you know?** The token safeguards against unauthorized access, ensuring that only you can install Alloy on your Mac.

Install Alloy by completing the following steps:

01. In the **Install Alloy** section, click **Run Grafana Alloy**.
02. Perform one of the following:
    
    Expand table
    
    | If you want to        | Then                                                                                                           |
    |-----------------------|----------------------------------------------------------------------------------------------------------------|
    | Create a new token    | Click **Create new token**, enter a meaningful token name (e.g., `MyMacBookPro`), then click **Create token**. |
    | Use an existing token | Click **Use an existing token** and enter a token you have created in the past.                                |
    
    **Tip:** You don’t need to copy the token. The token is added to a Grafana Alloy configuration command that you copy and run in a later step.
03. Verify that the **Enable Remote Configuration** toggle is set to on.
04. Log in to the Mac as a user with administrator permissions and open Terminal. Run the following command to install Alloy:
    
    ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```none
    brew install grafana/grafana/alloy
    ```
    
    **Tip:** It may take a few minutes to install Alloy. Hang in there!
05. Return to Grafana Cloud in your browser and scroll down to the **Set up the Alloy Configuration** section.
06. Click **Copy to Clipboard** to copy a command to generate an Alloy configuration file.
07. Paste the contents of the clipboard into the terminal and press **Enter**. Enter your macOS password when requested.
    
    Once the command completes, you’ll see `Alloy is ready to run` in the terminal.
08. Enter the following command to restart Alloy:
    
    ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```none
    brew services restart grafana/grafana/alloy
    ```
    
    If you see `Successfully started alloy`, then Alloy is running.
09. Return to Grafana Cloud in your browser and click **Test Alloy connection**.
    
    If Grafana Alloy is installed correctly, you’ll see `Awesome! Grafana Alloy is good to go`.
    
    **Tip:** Testing the Alloy connection may take a minute or two. If the test initially times out, try clicking **Test Alloy connection** again.
10. Once Alloy is successfully installed, click **Proceed to install integration**.

* * *

### More to explore (optional)

- [What is Grafana Alloy?](/oss/alloy-opentelemetry-collector)
- [How Grafana Alloy Works: Demo (Video)](https://www.youtube.com/watch?v=NrnLyDXpfq0)
- [Grafana Alloy on GitHub](https://github.com/grafana/alloy)
- [macOS Integration Reference](/docs/grafana-cloud/monitor-infrastructure/integrations/integration-reference/integration-macos-node/)

* * *

### Troubleshooting

Explore the following troubleshooting topics if you need help:

- [Common errors when executing Alloy installation script](/docs/grafana-cloud/monitor-infrastructure/integrations/troubleshoot/install-troubleshoot-mac-alloy/#common-errors-when-executing-alloy-installation-script)
- [Common errors when configuring Alloy for Integrations - Test Data Connection button](/docs/grafana-cloud/monitor-infrastructure/integrations/troubleshoot/install-troubleshoot-mac-alloy/#common-errors-when-configuring-alloy-for-integrations---test-data-connection-button)