rpk redpanda config bootstrap

Initialize the configuration to bootstrap a cluster.

This command generates a redpanda.yaml configuration file to bootstrap a cluster. If you are modifying the configuration file further, it is recommended to first bootstrap and then modify. If the file already exists, this command will set fields as requested by flags, and this may undo some of your earlier edits.

The --ips flag specifies seed servers (ips, ip:ports, or hostnames) that this broker will use to form a cluster.

By default, redpanda expects your machine to have one private IP address, and redpanda will listen on it. If your machine has multiple private IP addresses, you must use the --self flag to specify which ip redpanda should listen on.


rpk redpanda config bootstrap [--self <ip>] [--ips <ip1,ip2,...>] [flags]


Value Type Description

-h, --help


Help for bootstrap.



Comma-separated list of the seed node addresses or hostnames; at least three are recommended.



Optional IP address for redpanda to listen on; if empty, defaults to a private address.



Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD, and /etc/redpanda/redpanda.yaml.

-X, --config-opt


Override rpk configuration settings; '-X help' for detail or '-X list' for terser detail.



rpk profile to use.

-v, --verbose


Enable verbose logging.