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
Property | Description |
---|---|
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. Note: This property is required, and must not be changed once a node joins a cluster. Default: Null |
data_directory | The folder where Redpanda streaming data files are stored. Default: /var/lib/redpanda/data |
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. |