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.

The flags --advertised-kafka and --advertised-rpc specify the advertised addresses that this broker will use to advertise the corresponding listeners. If not set, it will default to the private IP address or the one specified with the --self flag.

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.

This command is only available on Linux.

Usage

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

Flags

Value Type Description

--advertised-kafka

string

Optional address:port for Redpanda to advertise the kafka listener; if empty, defaults to --self.

--advertised-rpc

string

Optional address:port for Redpanda to advertise the rpc listener; if empty, defaults to --self.

--ips

stringSlice

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

--self

string

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

Global flags

Value Type Description

--config

string

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

-X, --config-opt

stringArray

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

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.