Node Configuration Properties

Node configuration properties are applied individually to each node in a cluster. The following table lists each node configuration property in alphabetical order, along with its description and default setting. After you change a node-level property setting, you must restart the node for the change to take effect.

Required properties

note

You must include the following required properties in your configuration. If you omit them, redpanda will not start.

Property	Description
data_directory	The folder where Redpanda streaming data files are stored.
node_id	A number that identifies the node within the cluster. This value can be assigned automatically by a deployment tool, or it can be assigned by the user. Each node must have a unique node_id, and nodes should be numbered in sequence. This property must not be changed once a node joins a cluster.

Optional properties

Property	Description
admin	Address and port of the admin server. Default: 127.0.0.1:9644
admin_api_doc_dir	Path to the admin API documentation directory. Default: /usr/share/redpanda/admin-api-doc
admin_api_tls	TLS configuration for the admin HTTP server. Default: Null.
advertised_kafka_api	Address of Kafka API published to clients. Default: an empty array.
advertised_rpc_api	Address of the RPC endpoint published to other cluster members. Default: Null.
cloud_storage_cache_directory	The directory where the cache archive is stored. This property is mandatory when cloud_storage_enabled is set to true. Default: Null.
coproc_supervisor_server	IP address and port for supervisor service. Default: 127.0.0.1:43189.
dashboard_dir	The directory where the HTTP dashboard is located. Default: Null.
developer_mode	Skips most of the checks performed at startup. Not recommended for production use. Default: True
kafka_api	Address of the Kafka API that handles requests. Default: 127.0.0.1:9092.
kafka_api_tls	Transport Layer Security (TLS) configuration for the Kafka API endpoint. Default: Null.
rack	A rack is a label that identifies a failure zone. Apply the same label to all nodes in the same failure zone. When enable_rack_awareness is set to true at the cluster level, the system uses the rack labels to spread partition replicas across different failure zones. Default: Null.
rpc_server	Remote Procedure Call (RPC) server IP address. Default: 127.0.0.1:33145.
rpc_server_tls	TLS configuration for RPC server. Default: Null
seed_servers	List of the seed servers used to join the current cluster. If the seed_servers list is empty, the node will be a cluster root and it will form a new cluster. Default: Null.