Docs Self-Managed Manage Cluster Maintenance Configure Broker Properties This is documentation for Self-Managed v24.1. To view the latest available version of the docs, see v24.2. Configure Broker Properties When you install Redpanda, a redpanda.yaml file is installed on each broker in /etc/redpanda. This file contains broker configuration properties. A broker property is one that can be set differently from broker to broker, such as data_directory or node_id (when specified). See Broker Configuration Properties for a list of broker properties, their descriptions, and their default values. The default redpanda.yaml file groups broker properties into categories: pandaproxy - Properties for the Redpanda HTTP Proxy redpanda - Runtime configuration properties, such as the cluster member IP addresses and the data directory rpk - Properties that determine how rpk starts Redpanda schema registry - Properties related to storage, retrieval, and compatibility of the schemas Set broker configuration properties The redpanda.yaml file rarely needs to be edited after the system is installed, but you can choose to change broker configuration property values. The one broker configuration property you cannot change is the unique broker identifier: node_id. After a broker joins the cluster, do not change the node_id. You can altogether omit node_id from redpanda.yaml and have Redpanda assign it automatically. For more information, see Configure broker IDs. To change a broker property setting: Open a terminal window and navigate to the broker where you want to change a property setting. Go to the /etc/redpanda directory. Open the redpanda.yaml file. Change values for properties as needed. Save the file and close the editor. Restart the broker to apply the changes. When Redpanda starts up and reads the redpanda.yaml file, it checks that each property setting has a valid value. If the file contains an invalid property setting, Redpanda logs an error and refuses to start. Suggested labs Enable Plain Login Authentication for Redpanda ConsoleOwl Shop Example Application in DockerStart a Single Redpanda Broker with Redpanda Console in DockerStart a Cluster of Redpanda Brokers with Redpanda Console in DockerSearch all labs Back to top × Simple online edits For simple changes, such as fixing a typo, you can edit the content directly on GitHub. Edit on GitHub Or, open an issue to let us know about something that you want us to change. Open an issue Contribution guide For extensive content updates, or if you prefer to work locally, read our contribution guide . Was this helpful? thumb_up thumb_down group Ask in the community mail Share your feedback group_add Make a contribution Configure Cluster Properties Cluster Balancing