Docs Self-Managed Reference rpk Commands rpk cluster rpk cluster partitions rpk cluster partitions transfer-leadership You are viewing the Self-Managed v24.3 beta documentation. We welcome your feedback at the Redpanda Community Slack #beta-feedback channel. To view the latest available version of the docs, see v24.2. rpk cluster partitions transfer-leadership Transfer partition leadership between brokers. You can transfer only one partition leader at a time. Redpanda tries to balance leadership distribution across brokers by default. If the distribution of leaders becomes uneven as a result of transferring leadership across brokers, the cluster may move leadership back to the original brokers automatically. Usage rpk cluster partitions transfer-leadership [flags] Examples Transfer partition leadership: rpk cluster partitions transfer-leadership foo --partition 0:2 The preceding example shows how to transfer leadership for the partition kafka/foo/0 to broker 2. By default, it uses the kafka namespace, but you can specify an internal namespace using the {namespace}/ prefix. Equivalent command using different syntax: rpk cluster partitions transfer-leadership --partition foo/0:2 Flags Value Type Description --format string Output format. Possible values: json, yaml, text, wide, help. Default: text. -h, --help - Help for transfer-leadership. -p, --partition string The topic partition to which to transfer leadership and specify the new leader location. Syntax -p A:B where A is the partition leader and B will be the new leader. See Examples for how to use it. --config string Redpanda or rpk config file; default search paths are /var/lib/redpanda/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. -X, --config-opt stringArray Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail. --profile string Profile to use. See rpk profile for more details. -v, --verbose - Enable verbose logging. Back to top × Simple online edits For simple changes, such as fixing a typo, you can edit the content directly on GitHub. Edit on GitHub Or, open an issue to let us know about something that you want us to change. Open an issue Contribution guide For extensive content updates, or if you prefer to work locally, read our contribution guide . Was this helpful? thumb_up thumb_down group Ask in the community mail Share your feedback group_add Make a contribution rpk cluster partitions move-status rpk cluster partitions unsafe-recover