This is documentation for the next version of Alloy. For the latest stable release, go to the latest version.

DocumentationGrafana AlloyGet startedInstallKubernetes

Deploy Grafana Alloy on Kubernetes

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 Copy

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

2. Update the Grafana Helm chart repository:

   shell Copy

   helm repo update

3. Create a namespace for Alloy:

   shell Copy

   kubectl create namespace <NAMESPACE>

   Replace the following:

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

4. Install Alloy:

   shell Copy

   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 Copy

   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

• Configure Alloy