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

# Install Grafana Alloy

In this milestone, you install Grafana Alloy on your selected platform. Grafana Alloy collects PostgreSQL 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. **Create or select a token:**
   
   - **Create new token**: Click **Create new token**, enter a meaningful token name (e.g., `prodUS`), then click **Create token**.
   - **Use 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 prepare the PostgreSQL database configuration.

* * *

### 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)
- [Monitor multiple Linux hosts with the grafana\_agent role](/docs/alloy/latest/set-up/install/ansible/)
- [How Grafana Alloy Works: Demo (Video)](https://www.youtube.com/watch?v=NrnLyDXpfq0)
- [Grafana Alloy on GitHub](https://github.com/grafana/alloy)