rpk redpanda admin brokers decommission

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.

note

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.
--admin-api-tls-cert	string	The certificate to be used for TLS authentication with the Admin API.
--admin-api-tls-enabled	-	Enable TLS for the Admin API (not necessary if specifying custom certs).
--admin-api-tls-key	string	The certificate key to be used for TLS authentication with the Admin API.
--admin-api-tls-truststore	string	The truststore to be used for TLS communication with the Admin API.
--config	string	rpk config file, if not set the file will be searched for in the default locations.
--hosts	strings	A comma-separated list of Admin API addresses (<ip>:<port> You must specify one for each node.
-v, --verbose	-	Enable verbose logging (default false).