Skip to content
On this page

cluster elect-leaders

Generated from the CLI’s own command registry by scripts/generate-cli-docs.mjs — do not edit by hand; run that script again after changing a command.

kafka cluster elect-leaders

Trigger a preferred or unclean leader election on one or more partitions

Flags

Flag Description
--brokers <string> comma-separated broker list, e.g. localhost:9092
--election-type <string> preferred or unclean
--topic-partition <string> (repeatable) a “topic:partition” to elect a leader on (repeatable)
--all-topic-partitions elect on every eligible partition
--from-file <string> path to a kafka-leader-election.sh –path-to-json-file JSON file
--timeout <number> request timeout in ms
--dry-run print the election target and exit without connecting
--yes confirm the election without an interactive prompt
--force required for –election-type unclean, which can lose data

Examples

kafka cluster elect-leaders --election-type preferred --all-topic-partitions --brokers localhost:9092 --yes
kafka cluster elect-leaders --election-type unclean --topic-partition orders:0 --force --yes --brokers localhost:9092