---
title: "Deploy Grafana Alloy on Kubernetes | Grafana Alloy documentation"
description: "Learn how to deploy Grafana Alloy on Kubernetes"
---

# Deploy Grafana Alloy on Kubernetes

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](/docs/learning-journeys/kubernetes/).

[Start learning](https://grafana.com/docs/learning-journeys/kubernetes/)

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

## Before you begin

- Install [Helm](https://helm.sh) 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 code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   helm repo add grafana https://grafana.github.io/helm-charts
   ```
2. Update the Grafana Helm chart repository:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   helm repo update
   ```
3. Create a namespace for Alloy:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   kubectl create namespace <NAMESPACE>
   ```
   
   Replace the following:
   
   - *`<NAMESPACE>`* : The namespace to use for your Alloy installation, such as `alloy`.
4. Install Alloy:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```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 ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```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

- [Configure Alloy](../../../configure/kubernetes/)