Docs Self-Managed Reference rpk Commands rpk cluster rpk cluster maintenance This is documentation for Self-Managed v23.2, which is no longer supported. To view the latest available version of the docs, see v24.2. rpk cluster maintenance Interact with cluster maintenance mode. Maintenance mode is a state that a node may be placed into in which the node may be shutdown or restarted with minimal disruption to client workloads. The primary use of maintenance mode is to perform a rolling upgrade in which each node is placed into maintenance mode prior to upgrading the node. Use the enable and disable subcommands to place a node into maintenance mode or remove it, respectively. Only one node at a time may be in maintenance mode. When a node is placed into maintenance mode the following occurs: Leadership draining. All raft leadership is transferred to another eligible node, and the node in maintenance mode rejects new leadership requests. By transferring leadership off of the node in maintenance mode all client traffic and requests are directed to other nodes minimizing disruption to client workloads when the node is shutdown. Currently leadership is not transferred for partitions with one replica. Usage rpk cluster maintenance [flags] [command] Flags Value Type Description -h, --help - Help for maintenance. --config string Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD, and /etc/redpanda/redpanda.yaml. -X, --config-opt stringArray Override rpk configuration settings; '-X help' for detail or '-X list' for terser detail. --profile string rpk profile to use. -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 logdirs describe rpk cluster maintenance disable