---
title: "Configure Grafana Agent clustering in an existing installation | Grafana Agent documentation"
description: "Learn how to configure Grafana Agent clustering in an existing installation"
---

# Configure Grafana Agent Flow clustering in an existing installation

You can configure Grafana Agent Flow to run with [clustering](/docs/agent/v0.43/flow/concepts/clustering/) so that individual Grafana Agents can work together for workload distribution and high availability.

This topic describes how to add clustering to an existing installation.

## Configure Grafana Agent Flow clustering with Helm Chart

This section guides you through enabling clustering when Grafana Agent Flow is installed on Kubernetes using the Grafana Agent [Helm chart](/docs/agent/v0.43/flow/get-started/install/kubernetes/).

### Before you begin

- Ensure that your `values.yaml` file has `controller.type` set to `statefulset`.

### Steps

To configure clustering:

1. Amend your existing `values.yaml` file to add `clustering.enabled=true` inside the `agent` block.
   
   YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```yaml
   agent:
     clustering:
       enabled: true
   ```
2. Upgrade your installation to use the new `values.yaml` file:
   
   Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```bash
   helm upgrade <RELEASE_NAME> -f values.yaml
   ```
   
   Replace the following:
   
   - *`<RELEASE_NAME>`* : The name of the installation you chose when you installed the Helm chart.
3. Use the Grafana Agent Flow [UI](/docs/agent/v0.43/flow/tasks/debug/#component-detail-page) to verify the cluster status:
   
   1. Click **Clustering** in the navigation bar.
   2. Ensure that all expected nodes appear in the resulting table.