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

# Install Grafana Alloy

The next step in your journey takes you to installing 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 token.

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

To install Alloy, complete the following steps:

Watch video ->

1. In the **Install Alloy** section, click **Run Grafana Alloy**.
2. 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., `prodUS`), 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 the install Grafana Alloy script that you copy in the next step.
3. Verify that the **Enable Remote Configuration** toggle is set to on.
4. In the **Install and run Grafana Alloy** section, click **Copy to Clipboard**.
5. Log in to the Linux machine and open the Terminal. Paste the contents of the clipboard into the terminal and press **Enter**.
   
   This command installs Grafana Alloy on the Linux machine. When the installation is complete, you’ll see `Alloy is now running!`
6. To verify that Grafana Alloy is installed correctly, click **Test Alloy connection**.
   
   If Grafana Alloy is installed correctly, you’ll see `Awesome! Grafana Alloy is good to go`.
7. If Alloy is successfully installed, click **Proceed to install integration**.

* * *

### More to explore (optional)

- [What is Grafana Alloy?](/oss/alloy-opentelemetry-collector)
- [Monitor multiple Linux hosts with the grafana\_agent role](/docs/grafana-cloud/as-code/infrastructure-as-code/ansible/)
- [How Grafana Alloy Works: Demo (Video)](https://www.youtube.com/watch?v=NrnLyDXpfq0)
- [Grafana Alloy on GitHub](https://github.com/grafana/alloy)

* * *

### 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-linux-alloy/#common-errors-when-executing-alloy-installation-script)
- [Alloy is installed, but data doesn’t appear in Grafana Cloud](/docs/grafana-cloud/monitor-infrastructure/integrations/troubleshoot/install-troubleshoot-linux-alloy/#alloy-is-installed-but-data-doesnt-appear-in-grafana-cloud)