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

# Install Grafana Alloy

In this milestone, you install Grafana Alloy on your selected platform. Grafana Alloy collects MongoDB 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 Grafana Cloud, in the **2. Install Alloy** section, click **Run Grafana Alloy**.
2. 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 next steps.
3. Verify that the **Enable Remote Configuration** toggle switch is set to on.
4. In the **Install and run Grafana Alloy** section, click **Copy to Clipboard**.
5. Log into the machine on which you are installing Grafana Alloy and open the Terminal.
6. Paste the contents of the clipboard into the terminal and press **Enter**.
   
   This command installs Grafana Alloy on the machine. When the installation is complete, you’ll see `Alloy is now running!`
7. 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`.
8. If Alloy is successfully installed, click **Proceed to install integration**.

In your next milestone, you’ll configure the MongoDB 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)

At this point in your journey, you can explore the following paths:

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