Docs Self-Managed Reference rpk Commands rpk redpanda rpk redpanda admin rpk redpanda admin brokers rpk redpanda admin brokers decommission This is documentation for Self-Managed v24.2. To view the latest available version of the docs, see v24.3. rpk redpanda admin brokers decommission This command is not supported on macOS, Windows. Decommission the given broker. Decommissioning a broker removes it from the cluster. A decommission request is sent to every broker in the cluster, only the cluster leader handles the request. For safety on v22.x clusters, this command will not run if the requested broker is in maintenance mode. As of v23.x, Redpanda supports decommissioning a node that is currently in maintenance mode. If you are on a v22.x cluster and need to bypass the maintenance mode check (perhaps your cluster is unreachable), use the hidden --force flag. Usage rpk redpanda admin brokers decommission [BROKER ID] [flags] Flags Value Type Description -h, --help - Help for decommission. --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 redpanda admin brokers rpk redpanda admin brokers decommission-status