# Configure Continuous Data Balancing

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: Configure Continuous Data Balancing
latest-redpanda-tag: v26.1.9
latest-console-tag: v3.7.3
latest-operator-version: v26.1.4
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: March 31, 2027
latest-connect-version: 4.93.0
docname: cluster-maintenance/continuous-data-balancing
page-component-name: streaming
page-version: "26.1"
page-component-version: "26.1"
page-component-title: Streaming
page-relative-src-path: cluster-maintenance/continuous-data-balancing.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/manage/pages/cluster-maintenance/continuous-data-balancing.adoc
description: Continuous Data Balancing simplifies operations with self-healing clusters that dynamically balance partitions.
page-topic-type: how-to
personas: infrastructure_operator
learning-objective-1: Enable Continuous Data Balancing on a Redpanda cluster
learning-objective-2: Check data balancing status using rpk
learning-objective-3: Cancel partition balancing moves for a specific node
page-git-created-date: "2023-06-02"
page-git-modified-date: "2026-03-31"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/current/manage/cluster-maintenance/continuous-data-balancing.md -->

> 📝 **NOTE**
>
> This feature requires an [enterprise license](https://docs.redpanda.com/streaming/current/get-started/licensing/). To get a trial license key or extend your trial period, [generate a new trial license key](https://redpanda.com/try-enterprise). To purchase a license, contact [Redpanda Sales](https://redpanda.com/upgrade).
>
> If Redpanda has enterprise features enabled and it cannot find a valid license, [restrictions](https://docs.redpanda.com/streaming/current/get-started/licensing/#self-managed) apply.

Continuous Data Balancing continuously monitors your node and rack availability and disk usage, dynamically balancing partitions to maintain smooth operations and optimal cluster performance.

Continuous Data Balancing also maintains the configured replication level, even after infrastructure failure. Node availability has the highest priority in data balancing. After a rack (with all nodes belonging to it) becomes unavailable, Redpanda moves partition replicas to the remaining nodes. This violates the rack awareness constraint. After the rack (or a replacement rack) becomes available, Redpanda repairs the constraint by moving excess replicas from racks that have more than one replica to the newly-available rack.

After reading this page, you will be able to:

-   Enable Continuous Data Balancing on a Redpanda cluster

-   Check data balancing status using rpk

-   Cancel partition balancing moves for a specific node


## [](#set-continuous-data-balancing-properties)Set Continuous Data Balancing properties

To enable Continuous Data Balancing, set the `partition_autobalancing_mode` property to `continuous`. Customize the following properties to monitor node availability and disk usage.

| Property | Description |
| --- | --- |
| partition_autobalancing_node_availability_timeout_sec | When a node is unreachable for the specified amount of time, Redpanda acts as if the node had been decommissioned: rebalancing begins, re-creating all of its replicas on other nodes in the cluster.The node remains part of the cluster and can rejoin when it comes back online. A node that was actually decommissioned is removed from the cluster.Default is 900 seconds (15 minutes). |
| partition_autobalancing_node_autodecommission_timeout_sec | When a node is unavailable for this timeout duration, Redpanda automatically and permanently decommissions the node. This property only applies when partition_autobalancing_mode is set to continuous. Unlike partition_autobalancing_node_availability_timeout_sec, which moves partitions while keeping the node in the cluster, this property removes the node from the cluster entirely. A decommissioned node cannot rejoin the cluster.Only one node is decommissioned at a time. If a decommission is already in progress, automatic decommission does not trigger until it completes. If the decommission stalls (for example, because the node holds the only replica of a partition), manual intervention is required. See Node-wise Partition Recovery.By default, this property is null and automatic decommission is disabled. |
| partition_autobalancing_max_disk_usage_percent | When a node fills up to this disk usage percentage, Redpanda starts moving replicas off the node to other nodes with disk utilization below the percentage.Default is 80%. |

For the other `partition_autobalancing_mode` options, see [Cluster balancing](https://docs.redpanda.com/streaming/current/manage/cluster-maintenance/cluster-balancing/).

## [](#use-data-balancing-commands)Use data balancing commands

Use the following `rpk` commands to monitor and control data balancing.

### [](#check-data-balancing-status)Check data balancing status

To see the status, run:

```bash
rpk cluster partitions balancer-status
```

This shows the time since the last data balancing, the number of replica movements in progress, the nodes that are unavailable, and the nodes that are over the disk space threshold (default = 80%).

It also returns a data balancing status: `off`, `ready`, `starting`, `in-progress`, or `stalled`. If the command reports a `stalled` status, verify:

-   Are there enough healthy nodes? For example, in a three node cluster, no movements are possible for partitions with three replicas.

-   Does the cluster have sufficient space? Partitions are not moved if all nodes in the cluster are utilizing more than their disk space threshold.

-   Do all partitions have quorum? Partitions are not moved if the majority of its replicas are down.

-   Are any nodes in maintenance mode? Partitions are not moved if a node is in maintenance mode.


### [](#cancel-data-balancing-moves)Cancel data balancing moves

To cancel the current partition balancing moves, run:

```bash
rpk cluster partitions movement-cancel
```

To cancel partition moves on a specific node, use the `--node` flag. For example:

```bash
rpk cluster partitions movement-cancel --node 1
```

> 📝 **NOTE**
>
> If continuous balancing is still enabled and the cluster remains unbalanced, Redpanda schedules another partition balancing round. To stop all balancing, first set `partition_autobalancing_mode` to `off`, then cancel the current data balancing moves.

## Suggested labs

-   [Redpanda Iceberg Docker Compose Example](https://docs.redpanda.com/labs/docker-compose/iceberg/)
-   [Enable Unified Identity with Azure Entra ID for Redpanda and Redpanda Console](https://docs.redpanda.com/labs/docker-compose/oidc/)
-   [Owl Shop Example Application in Docker](https://docs.redpanda.com/labs/docker-compose/owl-shop/)
-   [Migrate Data with Redpanda Migrator](https://docs.redpanda.com/labs/docker-compose/redpanda-migrator/)
-   [Start a Single Redpanda Broker with Redpanda Console in Docker](https://docs.redpanda.com/labs/docker-compose/single-broker/)
-   [Start a Cluster of Redpanda Brokers with Redpanda Console in Docker](https://docs.redpanda.com/labs/docker-compose/three-brokers/)
-   [Iceberg Streaming on Kubernetes with Redpanda, MinIO, and Spark](https://docs.redpanda.com/labs/kubernetes/iceberg/)

See more

[Search all labs](https://docs.redpanda.com/labs)