---
title: "Install Grafana Alloy | Grafana Labs"
description: "Install Grafana Alloy on your selected platform to begin collecting MySQL metrics."
---

# Install Grafana Alloy

In this milestone, you install Grafana Alloy on your selected platform. Grafana Alloy collects MySQL metrics and forwards them to Grafana Cloud for monitoring and visualization.

Before installing Grafana Alloy, you need to obtain your Grafana Cloud configuration details to establish secure communication between Alloy and your Grafana Cloud stack.

To install Grafana Alloy, complete the following steps:

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 into the machine where you are installing Grafana Alloy, open the Terminal, and paste the contents of the clipboard. Press **Enter** to install Grafana Alloy.
   
   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**.

In your next milestone, you’ll configure the MySQL integration settings.

* * *

### 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)

* * *

### More to explore (optional)

- [Grafana Alloy configuration syntax and examples](/docs/alloy/latest/reference/config-blocks/)