# Configure Broker Properties

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: Configure Broker Properties
latest-redpanda-tag: v25.1.1
latest-console-tag: v3.7.3
latest-operator-version: v26.1.4
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "true"
page-eol-date: April 7, 2026
latest-connect-version: 4.93.0
docname: cluster-maintenance/node-property-configuration
page-component-name: streaming
page-version: "25.1"
page-component-version: "25.1"
page-component-title: Streaming
page-relative-src-path: cluster-maintenance/node-property-configuration.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/25.1/modules/manage/pages/cluster-maintenance/node-property-configuration.adoc
description: Learn how to configure broker properties with the <code>redpanda.yaml</code> file.
page-git-created-date: "2023-08-17"
page-git-modified-date: "2024-12-12"
support-status: past end-of-life
---

<!-- Source: https://docs.redpanda.com/streaming/25.1/manage/cluster-maintenance/node-property-configuration.md -->

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](https://docs.redpanda.com/streaming/25.1/reference/properties/broker-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)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.

> 📝 **NOTE**
>
> The broker configuration property [`node_id`](https://docs.redpanda.com/streaming/25.1/reference/properties/broker-properties/) is immutable. To ensure safe operations, omit the `node_id` field from `redpanda.yaml` and allow Redpanda to assign it automatically. For more information, see [Do not configure broker IDs](https://docs.redpanda.com/streaming/25.1/deploy/deployment-option/self-hosted/manual/production/production-deployment/#do-not-configure-broker-ids).

To change a broker property setting:

1.  Open a terminal window and navigate to the broker where you want to change a property setting.

2.  Go to the `/etc/redpanda` directory.

3.  Open the `redpanda.yaml` file.

4.  Change values for properties as needed.

5.  Save the file and close the editor.

6.  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

-   [Redpanda Iceberg Docker Compose Example](https://docs.redpanda.com/labs/docker-compose/iceberg/)
-   [Enable Unified Identity with Azure Entra ID for Redpanda and Redpanda Console](https://docs.redpanda.com/labs/docker-compose/oidc/)
-   [Owl Shop Example Application in Docker](https://docs.redpanda.com/labs/docker-compose/owl-shop/)
-   [Migrate Data with Redpanda Migrator](https://docs.redpanda.com/labs/docker-compose/redpanda-migrator/)
-   [Start a Single Redpanda Broker with Redpanda Console in Docker](https://docs.redpanda.com/labs/docker-compose/single-broker/)
-   [Start a Cluster of Redpanda Brokers with Redpanda Console in Docker](https://docs.redpanda.com/labs/docker-compose/three-brokers/)
-   [Iceberg Streaming on Kubernetes with Redpanda, MinIO, and Spark](https://docs.redpanda.com/labs/kubernetes/iceberg/)

See more

[Search all labs](https://docs.redpanda.com/labs)