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

# Deploy Grafana Agent Flow on Kubernetes

You can use a Helm chart to deploy Grafana Agent Flow on Kubernetes.

> Note
> 
> These instructions show you how to install using a generic [Helm chart](https://github.com/grafana/agent/tree/main/operations/helm/charts/grafana-agent) for Grafana Agent Flow. You can deploy Grafana Agent either in static mode or flow mode. The Helm chart deploys Grafana Agent Flow by default.

## Before you begin

- Install [Helm](https://helm.sh) on your computer.
- Configure a Kubernetes cluster that you can use for Grafana Agent Flow.
- Configure your local Kubernetes context to point to the cluster.

## Deploy

To deploy Grafana Agent 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 Grafana Agent Flow:
   
   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 Grafana Agent Flow installation, such as `agent`.
4. Install Grafana Agent:
   
   shell ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```shell
   helm install --namespace <NAMESPACE> <RELEASE_NAME> grafana/grafana-agent
   ```
   
   Replace the following:
   
   - *`<NAMESPACE>`* : The namespace created in the previous step.
   - *`<RELEASE_NAME>`* : The name to use for your Grafana Agent installation, such as `grafana-agent-flow`.
5. Verify that the Grafana Agent Flow 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 Grafana Agent Flow on Kubernetes, using default Helm settings. To configure Grafana Agent Flow, see the [Configure Grafana Agent Flow on Kubernetes](/docs/agent/next/flow/tasks/configure/configure-kubernetes/) guide.

## Next steps

- [Configure Grafana Agent Flow on Kubernetes](/docs/agent/next/flow/tasks/configure/configure-kubernetes/)
- Refer to the [Grafana Agent Flow Helm chart documentation on Artifact Hub](https://artifacthub.io/packages/helm/grafana/grafana-agent) for more information about Helm chart.