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

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.