Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Instrument and send databreadcrumb arrow Grafana Alloybreadcrumb arrow Set upbreadcrumb arrow Installbreadcrumb arrow Kubernetes
Grafana Cloud

Deploy Grafana Alloy on Kubernetes

Grafana Learning Journeys
Start your learning experience with Grafana Learning Paths

Grafana Learning Paths provide a clear, structured path that leads you from beginner concepts to advanced use cases. Learn about this Grafana feature on Monitor Kubernetes cluster infrastructure in Grafana Cloud.

Start learning

Alloy can be deployed on Kubernetes by using the Helm chart for Alloy.

Before you begin

  • Install Helm on your computer.
  • Configure a Kubernetes cluster that you can use for Alloy.
  • Configure your local Kubernetes context to point at the cluster.

Deploy

To deploy Alloy on Kubernetes using Helm, run the following commands in a terminal window:

  1. Add the Grafana Helm chart repository:

    shell 
    helm repo add grafana https://grafana.github.io/helm-charts

  2. Update the Grafana Helm chart repository:

    shell 
    helm repo update

  3. Create a namespace for Alloy:

    shell 
    kubectl create namespace <NAMESPACE>

    Replace the following:

    • <NAMESPACE>: The namespace to use for your Alloy installation, such as alloy.

  4. Install Alloy:

    shell 
    helm install --namespace <NAMESPACE> <RELEASE_NAME> grafana/alloy

    Replace the following:

    • <NAMESPACE>: The namespace created in the previous step.
    • <RELEASE_NAME>: The name to use for your Alloy installation, such as alloy.

  5. Verify that the Alloy pods are running:

    shell 
    kubectl get pods --namespace <NAMESPACE>

    Replace the following:

    • <NAMESPACE>: The namespace used in the previous step.

You have successfully deployed Alloy on Kubernetes, using default Helm settings.

Next steps