cluster-properties.adoc

// This content is autogenerated. Do not edit manually. To override descriptions, use the doc-tools CLI with the --overrides option: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1396244485/Review+Redpanda+configuration+properties
=== abort_index_segment_size

Capacity (in number of txns) of an abort index segment.

Each partition tracks the aborted transaction offset ranges to help service client requests. If the number of transactions increases beyond this threshold, they are flushed to disk to ease memory pressure. Then they're loaded on demand. This configuration controls the maximum number of aborted transactions before they are flushed to disk.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`50000`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== abort_timed_out_transactions_interval_ms

Interval, in milliseconds, at which Redpanda looks for inactive transactions and aborts them.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== admin_api_require_auth

Whether Admin API clients must provide HTTP basic authentication headers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== aggregate_metrics

Enable aggregation of metrics returned by the xref:reference:internal-metrics-reference.adoc[`/metrics`] endpoint. Aggregation can simplify monitoring by providing summarized data instead of raw, per-instance metrics. Metric aggregation is performed by summing the values of samples by labels and is done when it makes sense by the shard and/or partition labels.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

| Related topics
|xref:reference:internal-metrics-reference.adoc[`/metrics`]

|===


=== alive_timeout_ms

The amount of time since the last broker status heartbeat. After this time, a broker is considered offline and not alive.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== alter_topic_cfg_timeout_ms

The duration, in milliseconds, that Redpanda waits for the replication of entries in the controller log when executing a request to alter topic configurations. This timeout ensures that configuration changes are replicated across the cluster before the alteration request is considered complete.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== append_chunk_size

Size of direct write operations to disk in bytes. A larger chunk size can improve performance for write-heavy workloads, but increase latency for these writes as more data is collected before each write operation. A smaller chunk size can decrease write latency, but potentially increase the number of disk I/O operations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`16384`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`32768`

|===


=== audit_client_max_buffer_size

Defines the number of bytes allocated by the internal audit client for audit messages. When changing this, you must disable audit logging and then re-enable it for the change to take effect. Consider increasing this if your system generates a very large number of audit records in a short amount of time.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`16777216`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== audit_enabled

Enables or disables audit logging. When you set this to true, Redpanda checks for an existing topic named `_redpanda.audit_log`. If none is found, Redpanda automatically creates one for you.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
The following values require an Enterprise license: `true`

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== audit_enabled_event_types

List of strings in JSON style identifying the event types to include in the audit log. This may include any of the following: `management, produce, consume, describe, heartbeat, authenticate, schema_registry, admin`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[management, authenticate, admin]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`["management", "describe"]`

|===


// tag::redpanda-cloud[]
=== audit_excluded_principals

List of user principals to exclude from auditing.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`["User:principal1","User:principal2"]`

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== audit_excluded_topics

List of topics to exclude from auditing.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`["topic1","topic2"]`

|===

// end::redpanda-cloud[]

=== audit_failure_policy

Defines the policy for rejecting audit log messages when the audit log queue is full. If set to 'permit', then new audit messages are dropped and the operation is permitted.  If set to 'reject', then the operation is rejected.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`reject`, `permit`
endif::[]
ifdef::env-cloud[]
`reject`, `permit`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`reject`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== audit_log_num_partitions

Defines the number of partitions used by a newly-created audit topic. This configuration applies only to the audit log topic and may be different from the cluster or other topic configurations. This cannot be altered for existing audit log topics.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`12`
endif::[]

| Nullable
| No

| Unit
| Number of partitions per topic

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== audit_log_replication_factor

Defines the replication factor for a newly-created audit log topic. This configuration applies only to the audit log topic and may be different from the cluster or other topic configurations. This cannot be altered for existing audit log topics. Setting this value is optional. If a value is not provided, Redpanda will use the value specified for `internal_topic_replication_factor`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== audit_queue_drain_interval_ms

Interval, in milliseconds, at which Redpanda flushes the queued audit log messages to the audit log topic. Longer intervals may help prevent duplicate messages, especially in high throughput scenarios, but they also increase the risk of data loss during shutdowns where the queue is lost.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`500` (500 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== audit_queue_max_buffer_size_per_shard

Defines the maximum amount of memory in bytes used by the audit buffer in each shard. Once this size is reached, requests to log additional audit messages will return a non-retryable error. Limiting the buffer size per shard helps prevent any single shard from consuming excessive memory due to audit log messages.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1048576`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== audit_use_rpc

Use Redpanda's internal communication system to write audit logs. When disabled, Redpanda uses a Kafka client to write audit logs instead.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== auto_create_topics_enabled

Allow automatic topic creation. To prevent excess topics, this property is not supported on Redpanda Cloud BYOC and Dedicated clusters. You should explicitly manage topic creation for these Redpanda Cloud clusters.

If you produce to a topic that doesn't exist, the topic will be created with defaults if this property is enabled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::exclude-from-docs[]
=== cloud_topics_disable_reconciliation_loop

Disables the cloud topics reconciliation loop. Disabling the loop can negatively impact performance and stability of the cluster.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===

// end::exclude-from-docs[]

// tag::exclude-from-docs[]
=== cloud_topics_enabled

Enable cloud topics.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
The following values require an Enterprise license: `true`

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::exclude-from-docs[]

=== cloud_topics_epoch_service_epoch_increment_interval

ifndef::env-cloud[]
*Introduced in v25.3.3*
endif::[]

The interval, in milliseconds, at which the cluster epoch is incremented.

The cluster epoch is a frozen point in time of the committed offset of the controller log, used to coordinate partition creation and track changes in Tiered Storage. This property controls how frequently the epoch is refreshed. More frequent updates provide finer-grained coordination but may increase overhead.

Decrease this interval if you need more frequent epoch updates for faster coordination in Tiered Storage operations, or increase it to reduce coordination overhead in stable clusters.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`600000` (10 minutes)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== cloud_topics_epoch_service_local_epoch_cache_duration

ifndef::env-cloud[]
*Introduced in v25.3.3*
endif::[]

The duration, in milliseconds, for which a cluster-wide epoch is cached locally on each broker.

Caching the epoch locally reduces the need for frequent coordination with the controller. This property controls how long each broker can use a cached epoch value before fetching the latest value.

Increase this value to reduce coordination overhead in clusters with stable workloads. Decrease it if you need brokers to react more quickly to epoch changes in Tiered Storage.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`60000` (1 minute)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::exclude-from-docs[]
=== cloud_topics_long_term_garbage_collection_interval

Time interval after which data is garbage collected from long term storage.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`300000` (5 minutes)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===

// end::exclude-from-docs[]

// tag::exclude-from-docs[]
=== cloud_topics_produce_batching_size_threshold

The size limit for the object size in cloud topics. When the amount of data on a shard reaches this limit, an upload is triggered.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`4194304`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::exclude-from-docs[]

// tag::exclude-from-docs[]
=== cloud_topics_produce_cardinality_threshold

Threshold for the object cardinality in cloud topics. When the number of partitions in waiting for the upload reach this limit, an upload is triggered.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::exclude-from-docs[]

// tag::exclude-from-docs[]
=== cloud_topics_produce_upload_interval

Time interval after which the upload is triggered.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`250` (250 milliseconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::exclude-from-docs[]

// tag::exclude-from-docs[]
=== cloud_topics_reconciliation_interval

Time interval after which data is moved from short term storage to long term storage.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===

// end::exclude-from-docs[]

=== cloud_topics_short_term_gc_backoff_interval

ifndef::env-cloud[]
*Introduced in v25.3.3*
endif::[]

The interval, in milliseconds, between invocations of the L0 garbage collection work loop when no progress is being made or errors are occurring.

L0 (level-zero) objects are short-term data objects in Tiered Storage that are periodically garbage collected. When GC encounters errors or cannot make progress (for example, if there are no objects eligible for deletion), this backoff interval prevents excessive retries.

Increase this value to reduce system load when GC cannot make progress. Decrease it if you need faster retry attempts after transient errors.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`60000` (1 minute)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== cloud_topics_short_term_gc_interval

ifndef::env-cloud[]
*Introduced in v25.3.3*
endif::[]

The interval, in milliseconds, between invocations of the L0 (level-zero) garbage collection work loop when progress is being made.

L0 objects are short-term data objects in Tiered Storage associated with global epochs. This property controls how frequently GC runs when it successfully deletes objects. Lower values increase GC frequency, which can help maintain lower object counts but may increase S3 API usage.

Decrease this value if L0 object counts are growing too quickly and you need more aggressive garbage collection. Increase it to reduce S3 API costs in clusters with lower ingestion rates.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== cloud_topics_short_term_gc_minimum_object_age

ifndef::env-cloud[]
*Introduced in v25.3.3*
endif::[]

The minimum age, in milliseconds, of an L0 (level-zero) object before it becomes eligible for garbage collection.

This grace period delays deletion of L0 objects even after they become eligible based on epoch. The delay provides a safety buffer that can support recovery in cases involving accidental deletion or other operational issues.

Increase this value to extend the retention window for L0 objects, providing more time for recovery from operational errors. Decrease it to free up object storage space more quickly, but with less protection against accidental deletion.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`43200000` (12 hours)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== cluster_id

Cluster identifier.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| No
endif::[]

|===


=== compacted_log_segment_size

Size (in bytes) for each compacted log segment.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`268435456`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`268435456`

|===


=== compaction_ctrl_backlog_size

Target backlog size for compaction controller. If not set the max backlog size is configured to 80% of total disk space available.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== compaction_ctrl_d_coeff

Derivative coefficient for compaction PID controller.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.2`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== compaction_ctrl_i_coeff

Integral coefficient for compaction PID controller.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== compaction_ctrl_max_shares

Maximum number of I/O and CPU shares that compaction process can use.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== compaction_ctrl_min_shares

Minimum number of I/O and CPU shares that compaction process can use.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== compaction_ctrl_p_coeff

Proportional coefficient for compaction PID controller. This must be negative, because the compaction backlog should decrease when the number of compaction shares increases.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`-12.5`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== compaction_ctrl_update_interval_ms

The interval (in milliseconds) for updating the controller responsible for compaction tasks. The controller uses this interval to decide how to prioritize background compaction work, which is essential for maintaining efficient storage use.

This is an internal-only configuration and should be enabled only after consulting with Redpanda support.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== consumer_group_lag_collection_interval

How often Redpanda runs the collection loop when `enable_consumer_group_metrics` is set to `consumer_lag`. Updates will not be more frequent than `health_monitor_max_metadata_age`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`60` (1 minute)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== consumer_group_lag_collection_interval_sec

How often to run the collection loop when <<enable_consumer_group_metrics,`enable_consumer_group_metrics`>> contains `consumer_lag`.

Reducing the value of `consumer_group_lag_collection_interval_sec` increases the metric collection frequency, which may raise resource utilization. In most environments, this impact is minimal, but it's best practice to monitor broker resource usage in high-scale settings.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Seconds

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== consumer_offsets_topic_batch_cache_enabled

This property lets you enable the batch cache for the consumer offsets topic. By default, the cache for consumer offsets topic is disabled. Changing this property is not recommended in production systems, as it may affect performance. The change is applied only after the restart.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_backend_housekeeping_interval_ms

Interval between iterations of controller backend housekeeping loop.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000` (1 second)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_backend_reconciliation_concurrency

The maximum number of cluster updates the controller can process at the same time. Higher values speed up cluster changes but use more resources.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1024`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_log_accummulation_rps_capacity_acls_and_users_operations

Maximum capacity of rate limit accumulation in controller ACLs and users operations limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_log_accummulation_rps_capacity_configuration_operations

Maximum capacity of rate limit accumulation in controller configuration operations limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_log_accummulation_rps_capacity_move_operations

Maximum capacity of rate limit accumulation in controller move operations limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_log_accummulation_rps_capacity_node_management_operations

Maximum capacity of rate limit accumulation in controller node management operations limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_log_accummulation_rps_capacity_topic_operations

Maximum capacity of rate limit accumulation in controller topic operations limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== controller_snapshot_max_age_sec

Maximum amount of time before Redpanda attempts to create a controller snapshot after a new controller command appears.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`60` (1 minute)
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== coproc_max_batch_size

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== coproc_max_inflight_bytes

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== coproc_max_ingest_bytes

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== coproc_offset_flush_interval_ms

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== core_balancing_continuous

If set to `true`, move partitions between cores in runtime to maintain balanced partition distribution.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
*License-based defaults:*

* *Community:* `false` (if no Enterprise license is present)
* *Enterprise:* `true` (if an Enterprise license is present)

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== core_balancing_debounce_timeout

Interval, in milliseconds, between trigger and invocation of core balancing.

*Unit*: milliseconds

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== core_balancing_on_core_count_change

If set to `true`, and if after a restart the number of cores changes, Redpanda will move partitions between cores to maintain balanced partition distribution.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== cpu_profiler_enabled

Enables CPU profiling for Redpanda.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== cpu_profiler_sample_period_ms

The sample period for the CPU profiler.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100` (100 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== create_topic_timeout_ms

Timeout, in milliseconds, to wait for new topic creation.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`2000` (2 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== data_transforms_binary_max_size

The maximum size for a deployable WebAssembly binary that the broker can store.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`10485760`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===

// end::redpanda-cloud[]

=== data_transforms_commit_interval_ms

The commit interval at which data transforms progress.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000` (3 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== data_transforms_enabled

Enables WebAssembly-powered data transforms directly in the broker. When `data_transforms_enabled` is set to `true`, Redpanda reserves memory for data transforms, even if no transform functions are currently deployed. This memory reservation ensures that adequate resources are available for transform functions when they are needed, but it also means that some memory is allocated regardless of usage.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== data_transforms_logging_buffer_capacity_bytes

Buffer capacity for transform logs, per shard. Buffer occupancy is calculated as the total size of buffered log messages; that is, logs emitted but not yet produced.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`512000`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== data_transforms_logging_flush_interval_ms

Flush interval for transform logs. When a timer expires, pending logs are collected and published to the `transform_logs` topic.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`500` (500 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== data_transforms_logging_line_max_bytes

Transform log lines truncate to this length. Truncation occurs after any character escaping.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`1024`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== data_transforms_per_core_memory_reservation

The amount of memory to reserve per core for data transform (Wasm) virtual machines. Memory is reserved on boot. The maximum number of functions that can be deployed to a cluster is equal to `data_transforms_per_core_memory_reservation` / `data_transforms_per_function_memory_limit`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`20971520`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Aliases
| `wasm_per_core_memory_reservation`
endif::[]

| Example
|
`26214400`

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== data_transforms_per_function_memory_limit

The amount of memory to give an instance of a data transform (Wasm) virtual machine. The maximum number of functions that can be deployed to a cluster is equal to `data_transforms_per_core_memory_reservation` / `data_transforms_per_function_memory_limit`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`2097152`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Aliases
| `wasm_per_function_memory_limit`
endif::[]

| Example
|
`5242880`

|===

// end::redpanda-cloud[]

=== data_transforms_read_buffer_memory_percentage

include::reference:partial$internal-use-property.adoc[]

The percentage of available memory in the transform subsystem to use for read buffers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`45`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`25`

|===


=== data_transforms_runtime_limit_ms

The maximum amount of runtime to start up a data transform, and the time it takes for a single record to be transformed.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000` (3 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== data_transforms_write_buffer_memory_percentage

include::reference:partial$internal-use-property.adoc[]

The percentage of available memory in the transform subsystem to use for write buffers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`45`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`25`

|===


=== datalake_coordinator_snapshot_max_delay_secs

Maximum amount of time the coordinator waits to snapshot after a command appears in the log.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`15 minutes`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== datalake_disk_space_monitor_enable

Option to explicitly disable enforcement of datalake disk space usage.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::deprecated[]
=== datalake_disk_space_monitor_interval

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== datalake_disk_usage_overage_coeff

The datalake disk usage monitor reclaims the overage multiplied by this this coefficient to compensate for data that is written during the idle period between control loop invocations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`2`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`1.8`

|===


=== datalake_scheduler_block_size_bytes

Size, in bytes, of each memory block reserved for record translation, as tracked by the datalake scheduler.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`4194304`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== datalake_scheduler_disk_reservation_block_size

The size, in bytes, of the block of disk reservation that the datalake manager will assign to each datalake scheduler when it runs out of local reservation.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`52428800`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`10000000`

|===


=== datalake_scheduler_max_concurrent_translations

The maximum number of translations that the datalake scheduler will allow to run at a given time. If a translation is requested, but the number of running translations exceeds this value, the request will be put to sleep temporarily, polling until capacity becomes available.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`4`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== datalake_scheduler_time_slice_ms

Time, in milliseconds, for a datalake translation as scheduled by the datalake scheduler. After a translation is scheduled, it will run until either the time specified has elapsed or all pending records on its source partition have been translated.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== datalake_scratch_space_size_bytes

Size, in bytes, of the amount of scratch space datalake should use.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5368709120`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== datalake_scratch_space_soft_limit_size_percent

Size of the scratch space datalake soft limit expressed as a percentage of the `datalake_scratch_space_size_bytes` configuration value.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`80`
endif::[]

| Nullable
| No

| Unit
| Percent

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`80.0`

|===


=== datalake_translator_flush_bytes

Size, in bytes, of the amount of per translator data that may be flushed to disk before the translator will upload and remove its current on disk data.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`33554432`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== debug_bundle_auto_removal_seconds

If set, how long debug bundles are kept in the debug bundle storage directory after they are created. If not set, debug bundles are kept indefinitely.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== debug_bundle_storage_dir

Path to the debug bundle storage directory. Note: Changing this path does not clean up existing debug bundles. If not set, the debug bundle is stored in the Redpanda data directory specified in the redpanda.yaml broker configuration file.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== debug_load_slice_warning_depth

The recursion depth after which debug logging is enabled automatically for the log reader.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== default_leaders_preference

Default settings for preferred location of topic partition leaders. It can be either "none" (no preference), or "racks:<rack1>,<rack2>,..." (prefer brokers with rack ID from the list).

The list can contain one or more rack IDs. If you specify multiple IDs, Redpanda tries to distribute the partition leader locations equally across brokers in these racks.

If config_ref:enable_rack_awareness,true,properties/cluster-properties[] is set to `false`, leader pinning is disabled across the cluster.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
This property requires an Enterprise license to use.

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `object`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`none`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:develop:produce-data/leader-pinning.adoc[Leader pinning]

|===


=== default_num_windows

Default number of quota tracking windows.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== default_topic_partitions

Default number of partitions per topic.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1`
endif::[]

| Nullable
| No

| Unit
| Number of partitions per topic

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== default_topic_replication

Default replication factor for new topics.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== default_window_sec

Default quota tracking window size in milliseconds.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000 milliseconds`
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== disable_batch_cache

Disable batch cache in log manager.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== disable_cluster_recovery_loop_for_tests

include::reference:partial$internal-use-property.adoc[]

Disables the cluster recovery loop. This property is used to simplify testing and should not be set in production.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== disable_metrics

Disable registering the metrics exposed on the internal `/metrics` endpoint.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===


=== disable_public_metrics

Disable registering the metrics exposed on the `/public_metrics` endpoint.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===


=== disk_reservation_percent

The percentage of total disk capacity that Redpanda will avoid using. This applies both when cloud cache and log data share a disk, as well 
as when cloud cache uses a dedicated disk. 

It is recommended to not run disks near capacity to avoid blocking I/O due to low disk space, as well as avoiding performance issues associated with SSD garbage collection.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`25`
endif::[]

| Nullable
| No

| Unit
| Percent

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`25.0`

|===


=== election_timeout_ms

Raft election timeout expressed in milliseconds.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::deprecated[]
=== enable_admin_api

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== enable_auto_rebalance_on_node_add

Enable automatic partition rebalancing when new nodes are added

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Deprecated
endif::[]

|===

// end::deprecated[]

=== enable_cluster_metadata_upload_loop

Enables cluster metadata uploads. Required for xref:manage:whole-cluster-restore.adoc[whole cluster restore].

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|xref:manage:whole-cluster-restore.adoc[whole cluster restore]

|===


// tag::redpanda-cloud[]
=== enable_consumer_group_metrics

List of enabled consumer group metrics. Accepted values include:

- `group`: Enables the xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_consumers[`redpanda_kafka_consumer_group_consumers`] and xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_topics[`redpanda_kafka_consumer_group_topics`] metrics.
- `partition`: Enables the xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_committed_offset[`redpanda_kafka_consumer_group_committed_offset`] metric.
- `consumer_lag`: Enables the xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_lag_max[`redpanda_kafka_consumer_group_lag_max`] and xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_lag_sum[`redpanda_kafka_consumer_group_lag_sum`] metrics
+
Enabling `consumer_lag` may add a small amount of additional processing overhead to the brokers, especially in environments with a high number of consumer groups or partitions.
+

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`[group, partition]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

| Related topics
|
* xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_consumers[`redpanda_kafka_consumer_group_consumers`]

* xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_topics[`redpanda_kafka_consumer_group_topics`]

* xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_committed_offset[`redpanda_kafka_consumer_group_committed_offset`]

* xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_lag_max[`redpanda_kafka_consumer_group_lag_max`]

* xref:reference:public-metrics-reference.adoc#redpanda_kafka_consumer_group_lag_sum[`redpanda_kafka_consumer_group_lag_sum`]

* xref:reference:properties/cluster-properties.adoc#consumer_group_lag_collection_interval_sec[`consumer_group_lag_collection_interval_sec`]

ifndef::env-cloud[]
* xref:manage:monitoring.adoc#consumers[Monitor consumer group lag]
endif::[]

ifdef::env-cloud[]
* xref:manage:monitor-cloud.adoc#consumers[Monitor consumer group lag]
endif::[]

|===

// end::redpanda-cloud[]

=== enable_controller_log_rate_limiting

Limits the write rate for the controller log.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::deprecated[]
=== enable_coproc

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::exclude-from-docs[]
=== enable_developmental_unrecoverable_data_corrupting_features

Configuration property: enable_developmental_unrecoverable_data_corrupting_features

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::exclude-from-docs[]

=== enable_host_metrics

Enable exporting of some host metrics like `/proc/diskstats`, `/proc/snmp` and `/proc/net/netstat`.

Host metrics are prefixed with xref:reference:internal-metrics-reference.adoc#vectorized_host_diskstats_discards[`vectorized_host`] and are available on the `/metrics` endpoint.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|xref:reference:internal-metrics-reference.adoc#vectorized_host_diskstats_discards[`vectorized_host`]

|===


=== enable_idempotence

Enable idempotent producers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== enable_leader_balancer

Enable automatic leadership rebalancing.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== enable_metrics_reporter

Enable the cluster metrics reporter. If `true`, the metrics reporter collects and exports to Redpanda Data a set of customer usage metrics at the interval set by <<metrics_reporter_report_interval,`metrics_reporter_report_interval`>>.

[NOTE]
====
The cluster metrics of the metrics reporter are different from xref:manage:monitoring.adoc[monitoring metrics].

* The metrics reporter exports customer usage metrics for consumption by Redpanda Data.
* Monitoring metrics are exported for consumption by Redpanda users.
====

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:monitoring.adoc[monitoring metrics]

|===


=== enable_mpx_extensions

Enable Redpanda extensions for MPX.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== enable_pid_file

Enable PID file. You should not need to change.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== enable_rack_awareness

Enable rack-aware replica assignment.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== enable_sasl

Enable SASL authentication for Kafka connections. Authorization is required to modify this property. See also <<kafka_enable_authorization,`kafka_enable_authorization`>>.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== enable_schema_id_validation

Controls whether Redpanda validates schema IDs in records and which topic properties are enforced.

Values:

* `none`: Schema validation is disabled (no schema ID checks are done). Associated topic properties cannot be modified.
* `redpanda`: Schema validation is enabled. Only Redpanda topic properties are accepted.
* `compat`: Schema validation is enabled. Both Redpanda and compatible topic properties are accepted.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
The following values require an Enterprise license: `compat`, `redpanda`

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`none`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:schema-reg/schema-id-validation.adoc[Server-Side Schema ID Validation]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== enable_shadow_linking

Enable creating shadow links from this cluster to a remote source cluster for data replication.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
The following values require an Enterprise license: `true`

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== enable_transactions

Enable transactions (atomic writes).

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== enable_usage

Enables the usage tracking mechanism, storing windowed history of kafka/cloud_storage metrics over time.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== features_auto_enable

Whether new feature flags auto-activate after upgrades (true) or must wait for manual activation via the Admin API (false).

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== fetch_max_bytes

Maximum number of bytes returned in a fetch request.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`57671680`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== fetch_max_read_concurrency

ifndef::env-cloud[]
*Introduced in v25.3.3*
endif::[]

The maximum number of concurrent partition reads per fetch request on each shard. Setting this higher than the default can lead to partition starvation and unneeded memory usage.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`1`

|===


=== fetch_pid_d_coeff

Derivative coefficient for fetch PID controller.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== fetch_pid_i_coeff

Integral coefficient for fetch PID controller.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.01`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== fetch_pid_max_debounce_ms

The maximum debounce time the fetch PID controller will apply, in milliseconds.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100` (100 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== fetch_pid_p_coeff

Proportional coefficient for fetch PID controller.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== fetch_pid_target_utilization_fraction

A fraction, between 0 and 1, for the target reactor utilization of the fetch scheduling group.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.2`
endif::[]

| Nullable
| No

| Unit
| Fraction

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== fetch_read_strategy

The strategy used to fulfill fetch requests.

* `polling`: If `fetch_reads_debounce_timeout` is set to its default value, then this acts exactly like `non_polling`; otherwise, it acts like `non_polling_with_debounce` (deprecated).
* `non_polling`: The backend is signaled when a partition has new data, so Redpanda does not need to repeatedly read from every partition in the fetch. Redpanda Data recommends using this value for most workloads, because it can improve fetch latency and CPU utilization.
* `non_polling_with_debounce`: This option behaves like `non_polling`, but it includes a debounce mechanism with a fixed delay specified by `fetch_reads_debounce_timeout` at the start of each fetch. By introducing this delay, Redpanda can accumulate more data before processing, leading to fewer fetch operations and returning larger amounts of data. Enabling this option reduces reactor utilization, but it may also increase end-to-end latency.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`polling`, `non_polling`, `non_polling_with_debounce`, `non_polling_with_pid`
endif::[]
ifdef::env-cloud[]
`polling`, `non_polling`, `non_polling_with_debounce`, `non_polling_with_pid`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`non_polling`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`model::fetch_read_strategy_to_string(         model::fetch_read_strategy::non_polling)`

|===


=== fetch_reads_debounce_timeout

Time to wait for the next read in fetch requests when the requested minimum bytes was not reached.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1` (1 millisecond)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== fetch_session_eviction_timeout_ms

Time duration after which the inactive fetch session is removed from the fetch session cache. Fetch sessions are used to implement the incremental fetch requests where a consumer does not send all requested partitions to the server but the server tracks them for the consumer.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`60000` (1 minute)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== find_coordinator_timeout_ms

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== full_raft_configuration_recovery_pattern

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== group_initial_rebalance_delay

Delay added to the rebalance phase to wait for new members.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000` (3 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== group_max_session_timeout_ms

The maximum allowed session timeout for registered consumers. Longer timeouts give consumers more time to process messages in between heartbeats at the cost of a longer time to detect failures.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`300000` (5 minutes)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===


=== group_min_session_timeout_ms

The minimum allowed session timeout for registered consumers. Shorter timeouts result in quicker failure detection at the cost of more frequent consumer heartbeating, which can overwhelm broker resources.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`6000` (6 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===


=== group_new_member_join_timeout

Timeout for new member joins.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== group_offset_retention_check_ms

Frequency rate at which the system should check for expired group offsets.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`600000` (10 minutes)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== group_offset_retention_sec

Consumer group offset retention seconds. To disable offset retention, set this to null.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`604800` (1 week)
endif::[]

| Nullable
| Yes

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===

// end::redpanda-cloud[]

=== group_topic_partitions

Number of partitions in the internal group membership topic.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`16`
endif::[]

| Nullable
| No

| Unit
| Number of partitions per topic

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== health_manager_tick_interval

How often the health manager runs.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`180000` (3 minutes)
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== health_monitor_max_metadata_age

Maximum age of the metadata cached in the health monitor of a non-controller broker.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== health_monitor_tick_interval

How often health monitor refresh cluster state

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Deprecated
endif::[]

|===

// end::deprecated[]

// tag::redpanda-cloud[]
=== http_authentication

A list of supported HTTP authentication mechanisms. Accepted Values: `BASIC`, `OIDC`.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
The following values require an Enterprise license: `OIDC`

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`[BASIC]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_backlog_controller_i_coeff

Controls how much past backlog (unprocessed work) affects the priority of processing new data in the Iceberg system. The system accumulates backlog errors over time, and this coefficient determines how much that accumulated backlog influences the urgency of data translation.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.005`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== iceberg_backlog_controller_p_coeff

Proportional coefficient for the Iceberg backlog controller. Number of shares assigned to the datalake scheduling group will be proportional to the backlog size error. A negative value means larger and faster changes in the number of shares in the datalake scheduling group.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.00001`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_catalog_base_location

Base path for the object-storage-backed Iceberg catalog. After Iceberg is enabled, do not change this value.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`redpanda-iceberg-catalog`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_catalog_commit_interval_ms

The frequency at which the Iceberg coordinator commits topic files to the catalog. This is the interval between commit transactions across all topics monitored by the coordinator, not the interval between individual commits.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1 minute`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_catalog_type

Iceberg catalog type that Redpanda will use to commit table metadata updates. Supported types: `rest`, `object_storage`.
NOTE: You must set <<iceberg_rest_catalog_endpoint,`iceberg_rest_catalog_endpoint`>> at the same time that you set `iceberg_catalog_type` to `rest`.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`object_storage`, `rest`
endif::[]
ifdef::env-cloud[]
`object_storage`, `rest`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`object_storage`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_default_catalog_namespace

ifndef::env-cloud[]
*Introduced in v25.3.5*
endif::[]

The default namespace (database name) for Iceberg tables. All tables created by Redpanda will be placed in this namespace within the Iceberg catalog. Supports nested namespaces as an array of strings.

IMPORTANT: This value must be configured before enabling Iceberg and must not be changed afterward. Changing it will cause Redpanda to lose track of existing tables.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[redpanda]`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_default_partition_spec

Default value for the `redpanda.iceberg.partition.spec` topic property that determines the partition spec for the Iceberg table corresponding to the topic.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`(hour(redpanda.timestamp))`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|
ifndef::env-cloud[]
* xref:reference:properties/topic-properties.adoc#redpanda-iceberg-partition-spec[`redpanda.iceberg.partition.spec`]
endif::[]

* xref:manage:iceberg/about-iceberg-topics.adoc#enable-iceberg-integration[Enable Iceberg integration]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_delete

Default value for the `redpanda.iceberg.delete` topic property that determines if the corresponding Iceberg table is deleted upon deleting the topic.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_disable_automatic_snapshot_expiry

Whether to disable automatic Iceberg snapshot expiry. This property may be useful if the Iceberg catalog expects to perform snapshot expiry on its own.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_disable_snapshot_tagging

Whether to disable tagging of Iceberg snapshots. These tags are used to ensure that the snapshots that Redpanda writes are retained during snapshot removal, which in turn, helps Redpanda ensure exactly-once delivery of records. Disabling tags is therefore not recommended, but it may be useful if the Iceberg catalog does not support tags.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_dlq_table_suffix

The suffix added to Iceberg table names when creating dead-letter queue (DLQ) tables for invalid records. Choose a suffix that won't conflict with existing table names. This is especially important for catalogs that don't support the tilde (~) character in table names. Don't change this value after creating DLQ tables.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`~dlq`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_enabled

Enables the translation of topic data into Iceberg tables. Setting `iceberg_enabled` to `true` activates the feature at the cluster level, but each topic must also set the `redpanda.iceberg.enabled` topic-level property to `true` to use it. If `iceberg_enabled` is set to `false`, then the feature is disabled for all topics in the cluster, overriding any topic-level settings.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
The following values require an Enterprise license: `true`

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Related topics
|xref:reference:properties/topic-properties.adoc#redpanda-iceberg-enabled[`redpanda.iceberg.enabled`]
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_invalid_record_action

Default value for the `redpanda.iceberg.invalid.record.action` topic property.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`drop`, `dlq_table`
endif::[]
ifdef::env-cloud[]
`drop`, `dlq_table`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`dlq_table`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Related topics
|
* xref:reference:properties/topic-properties.adoc#redpanda-iceberg-invalid-record-action[`redpanda.iceberg.invalid.record.action`]

* xref:manage:iceberg/about-iceberg-topics.adoc#troubleshoot-errors[Troubleshoot errors]
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_latest_schema_cache_ttl_ms

The TTL for caching the latest schema during translation when using the xref:manage:iceberg/specify-iceberg-schema.adoc#value_schema_latest[`value_schema_latest`] iceberg mode. This setting controls how long the latest schema remains cached during translation, which affects schema refresh behavior and performance.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5 minutes`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|xref:manage:iceberg/specify-iceberg-schema.adoc#value_schema_latest[`value_schema_latest`]

|===


// tag::redpanda-cloud[]
=== iceberg_rest_catalog_authentication_mode

The authentication mode for client requests made to the Iceberg catalog. Choose from: `none`, `bearer`, `oauth2`, and `aws_sigv4`. In `bearer` mode, the token specified in `iceberg_rest_catalog_token` is used unconditonally, and no attempts are made to refresh the token. In `oauth2` mode, the credentials specified in `iceberg_rest_catalog_client_id` and `iceberg_rest_catalog_client_secret` are used to obtain a bearer token from the URI defined by `iceberg_rest_catalog_oauth2_server_uri`. In `aws_sigv4` mode, the same AWS credentials used for cloud storage (see `cloud_storage_region`, `cloud_storage_access_key`, `cloud_storage_secret_key`, and `cloud_storage_credentials_source`) are used to sign requests to AWS Glue catalog with SigV4.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`none`, `bearer`, `oauth2`, `aws_sigv4`, `gcp`
endif::[]
ifdef::env-cloud[]
`none`, `bearer`, `oauth2`, `aws_sigv4`, `gcp`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`none`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`none`

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_aws_access_key

AWS access key for Iceberg REST catalog SigV4 authentication. If not set, falls back to xref:reference:properties/object-storage-properties.adoc#cloud_storage_access_key[`cloud_storage_access_key`] when using aws_sigv4 authentication mode.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/object-storage-properties.adoc#cloud_storage_access_key[`cloud_storage_access_key`]

|===

// end::redpanda-cloud[]

=== iceberg_rest_catalog_aws_credentials_source

*Accepted values*: `aws_instance_metadata`, `azure_aks_oidc_federation`, `azure_vm_instance_metadata`, `config_file`, `gcp_instance_metadata`, `sts`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`config_file`, `aws_instance_metadata`, `sts`, `gcp_instance_metadata`, `azure_aks_oidc_federation`, `azure_vm_instance_metadata`
endif::[]
ifdef::env-cloud[]
`config_file`, `aws_instance_metadata`, `sts`, `gcp_instance_metadata`, `azure_aks_oidc_federation`, `azure_vm_instance_metadata`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Aliases
| `iceberg_rest_catalog_aws_credentials_source`
endif::[]

| Example
|
`config_file`

| Related topics
|xref:reference:properties/object-storage-properties.adoc#cloud_storage_credentials_source[`cloud_storage_credentials_source`]

|===


// tag::redpanda-cloud[]
=== iceberg_rest_catalog_aws_region

AWS region for Iceberg REST catalog SigV4 authentication. If not set, falls back to xref:reference:properties/object-storage-properties.adoc#cloud_storage_region[`cloud_storage_region`] when using aws_sigv4 authentication mode.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/object-storage-properties.adoc#cloud_storage_region[`cloud_storage_region`]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_aws_secret_key

AWS secret key for Iceberg REST catalog SigV4 authentication. If not set, falls back to xref:reference:properties/object-storage-properties.adoc#cloud_storage_secret_key[`cloud_storage_secret_key`] when using aws_sigv4 authentication mode.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/object-storage-properties.adoc#cloud_storage_secret_key[`cloud_storage_secret_key`]

|===

// end::redpanda-cloud[]

=== iceberg_rest_catalog_aws_service_name

AWS service name for SigV4 signing when using aws_sigv4 authentication mode. Defaults to 'glue' for AWS Glue Data Catalog. Can be changed to support other AWS services that provide Iceberg REST catalog APIs.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`glue`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_rest_catalog_base_location

Base URI for the Iceberg REST catalog. If unset, the REST catalog server determines the location. Some REST catalogs, like AWS Glue, require the client to set this. After Iceberg is enabled, do not change this value.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_client_id

Iceberg REST catalog user ID. This ID is used to query the catalog API for the OAuth token. Required if catalog type is set to `rest` and `iceberg_rest_catalog_authentication_mode` is set to `oauth2`.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_client_secret

Secret used with the client ID to query the OAuth token endpoint for Iceberg REST catalog authentication. Required if catalog type is set to `rest` and `iceberg_rest_catalog_authentication_mode` is set to `oauth2`.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_crl

The contents of a certificate revocation list for `iceberg_rest_catalog_trust`. Takes precedence over `iceberg_rest_catalog_crl_file`.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_rest_catalog_crl_file

Path to certificate revocation list for `iceberg_rest_catalog_trust_file`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_rest_catalog_endpoint

URL of Iceberg REST catalog endpoint.
NOTE: If you set <<iceberg_catalog_type,`iceberg_catalog_type`>> to `rest`, you must also set this property at the same time.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`http://hostname:8181`

|===

// end::redpanda-cloud[]

=== iceberg_rest_catalog_gcp_user_project

The GCP project that is billed for charges associated with Iceberg REST Catalog requests.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_rest_catalog_oauth2_scope

The OAuth scope used to retrieve access tokens for Iceberg catalog authentication. Only meaningful when `iceberg_rest_catalog_authentication_mode` is set to `oauth2`

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`PRINCIPAL_ROLE:ALL`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_oauth2_server_uri

The OAuth URI used to retrieve access tokens for Iceberg catalog authentication. If left undefined, the deprecated Iceberg catalog endpoint `/v1/oauth/tokens` is used instead.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_request_timeout_ms

Maximum length of time that Redpanda waits for a response from the REST catalog before aborting the request

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_token

Token used to access the REST Iceberg catalog. If the token is present, Redpanda ignores credentials stored in the properties <<iceberg_rest_catalog_client_id,`iceberg_rest_catalog_client_id`>>  and <<iceberg_rest_catalog_client_secret,`iceberg_rest_catalog_client_secret`>>.

Required if <<iceberg_rest_catalog_authentication_mode, `iceberg_rest_catalog_authentication_mode`>> is set to `bearer`.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== iceberg_rest_catalog_trust

The contents of a certificate chain to trust for the REST Iceberg catalog.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_rest_catalog_trust_file

Path to a file containing a certificate chain to trust for the REST Iceberg catalog.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_rest_catalog_warehouse

Warehouse to use for the Iceberg REST catalog. Redpanda queries the catalog to retrieve warehouse-specific configurations and automatically configures settings like the appropriate prefix. The prefix is appended to the catalog path (for example, `/v1/\{prefix}/namespaces`).

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Aliases
| `iceberg_rest_catalog_prefix`
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_target_backlog_size

Average size per partition of the datalake translation backlog that the backlog controller tries to maintain. When the backlog size is larger than the set point, the backlog controller will increase the translation scheduling group priority.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`104857600`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_target_lag_ms

Default value for the `redpanda.iceberg.target.lag.ms` topic property, which controls how often the data in an Iceberg table is refreshed with new data from the corresponding Redpanda topic. Redpanda attempts to commit all data produced to the topic within the lag target, subject to resource availability.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`1 minute`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Related topics
|xref:reference:properties/topic-properties.adoc#redpanda-iceberg-target-lag-ms[`redpanda.iceberg.target.lag.ms`]
endif::[]

|===

// end::redpanda-cloud[]

=== iceberg_throttle_backlog_size_ratio

Ration of the total backlog size to the disk space at which the throttle to iceberg producers is applied.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== iceberg_topic_name_dot_replacement

A replacement string for dots in topic names when creating Iceberg table names. Use this when your downstream systems don't allow dots in table names. The replacement string cannot contain dots. Be careful to avoid table name collisions. Don't change this value after creating any Iceberg topics with dots in their names.

ifdef::env-cloud[]
NOTE: This property is available only in Redpanda Cloud BYOC deployments.
endif::[]


[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== id_allocator_batch_size

The ID allocator allocates messages in batches (each batch is a one log record) and then serves requests from memory without touching the log until the batch is exhausted.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== id_allocator_log_capacity

Capacity of the `id_allocator` log in number of batches. After it reaches `id_allocator_stm`, it truncates the log's prefix.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== id_allocator_replication

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== initial_retention_local_target_bytes_default

Initial local retention size target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then  all locally-retained data will be delivered to learner when joining the partition replica set.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:tiered-storage.adoc[Tiered Storage]

|===


=== initial_retention_local_target_ms_default

Initial local retention time target for partitions of topics with xref:manage:tiered-storage.adoc[Tiered Storage] enabled. If no initial local target retention is configured, then all locally-retained data will be delivered to learner when joining the partition replica is set.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:tiered-storage.adoc[Tiered Storage]

|===


=== internal_topic_replication_factor

Target replication factor for internal topics.

*Unit*: number of replicas per topic.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== join_retry_timeout_ms

Time between cluster join retries in milliseconds.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== kafka_admin_topic_api_rate

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== kafka_batch_max_bytes

The default maximum batch size for topics if the topic property xref:reference:properties/topic-properties.adoc[`message.max.bytes`] is not set. If the batch is compressed, the limit applies to the compressed batch size.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1048576`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc[`message.max.bytes`]

|===


// tag::deprecated[]
=== kafka_client_group_byte_rate_quota

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== kafka_client_group_fetch_byte_rate_quota

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== kafka_connection_rate_limit

Maximum connections per second for one core. If `null` (the default), then the number of connections per second is unlimited.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-9223372036854776000`, `9223372036854776000`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_connection_rate_limit_overrides

Overrides the maximum connections per second for one core for the specified IP addresses (for example, `['127.0.0.1:90', '50.20.1.1:40']`)

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`['127.0.0.1:90', '50.20.1.1:40']`

| Related topics
|
* xref:manage:cluster-maintenance/configure-availability.adoc#limit-client-connections[Limit client connections]

ifndef::env-cloud[]
* xref:manage:cluster-maintenance/configure-client-connections.adoc#limit-client-connections[Limit client connections]
endif::[]

|===


=== kafka_connections_max

Maximum number of Kafka client connections per broker. If `null`, the property is disabled.

*Unit*: number of Kafka client connections per broker

*Default*: null

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|
* xref:manage:cluster-maintenance/configure-availability.adoc#limit-client-connections[Limit client connections]

ifndef::env-cloud[]
* xref:manage:cluster-maintenance/configure-client-connections.adoc#limit-client-connections[Limit client connections]
endif::[]

|===


// tag::redpanda-cloud[]
=== kafka_connections_max_overrides

A list of IP addresses for which Kafka client connection limits are overridden and don't apply. For example, `(['127.0.0.1:90', '50.20.1.1:40']).`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`['127.0.0.1:90', '50.20.1.1:40']`

| Related topics
|
* xref:manage:cluster-maintenance/configure-availability.adoc#limit-client-connections[Limit client connections]

ifndef::env-cloud[]
* xref:manage:cluster-maintenance/configure-client-connections.adoc#limit-client-connections[Limit client connections]
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== kafka_connections_max_per_ip

Maximum number of Kafka client connections per IP address, per broker. If `null`, the property is disabled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|
* xref:manage:cluster-maintenance/configure-availability.adoc#limit-client-connections[Limit client connections]

ifndef::env-cloud[]
* xref:manage:cluster-maintenance/configure-client-connections.adoc#limit-client-connections[Limit client connections]
endif::[]

|===

// end::redpanda-cloud[]

=== kafka_enable_authorization

Flag to require authorization for Kafka connections. If `null`, the property is disabled, and authorization is instead enabled by <<enable_sasl, `enable_sasl`>>.

* `null`: Ignored. Authorization is enabled with `enable_sasl`: `true`
* `true`: authorization is required.
* `false`: authorization is disabled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_enable_partition_reassignment

Enable the Kafka partition reassignment API.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_fetch_request_timeout_ms

Broker-side target for the duration of a single fetch request. The broker will try to complete fetches within the specified duration, even if it means returning less bytes in the fetch than are available.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_group_recovery_timeout_ms

Kafka group recovery timeout.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_max_bytes_per_fetch

Limit fetch responses to this many bytes, even if the total of partition bytes limits is higher.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`67108864`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_max_message_size_upper_limit_bytes

The maximum value you can set for the xref:./topic-properties.adoc#maxmessagebytes[`max.message.bytes`] topic property. When set to `null`, no limit is enforced.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`104857600`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc#maxmessagebytes[`max.message.bytes`]

|===


// tag::deprecated[]
=== kafka_memory_batch_size_estimate_for_fetch

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== kafka_memory_share_for_fetch

The share of Kafka subsystem memory that can be used for fetch read buffers, as a fraction of the Kafka subsystem memory amount.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.5`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_mtls_principal_mapping_rules

Principal mapping rules for mTLS authentication on the Kafka API. If `null`, the property is disabled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_nodelete_topics

A list of topics that are protected from deletion and configuration changes by Kafka clients. Set by default to a list of Redpanda internal topics.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[_redpanda.audit_log, __consumer_offsets, _schemas]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|
* xref:develop:consume-data/consumer-offsets.adoc[Consumer Offsets]

* xref:manage:schema-registry.adoc[Schema Registry]

|===


=== kafka_noproduce_topics

A list of topics that are protected from being produced to by Kafka clients. Set by default to a list of Redpanda internal topics.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_produce_batch_validation

Controls the level of validation performed on batches produced to Redpanda. When set to `legacy`, there is minimal validation performed on the produce path. When set to `relaxed`, full validation is performed on uncompressed batches and on compressed batches with the `max_timestamp` value left unset. When set to `strict`, full validation of uncompressed and compressed batches is performed. This should be the default in environments where producing clients are not trusted.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`legacy`, `relaxed`, `strict`
endif::[]
ifdef::env-cloud[]
`legacy`, `relaxed`, `strict`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`relaxed`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_depth_alpha

Smoothing factor for Kafka queue depth control depth tracking.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.8`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_depth_update_ms

Update frequency for Kafka queue depth control.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`7000` (7 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_enable

Enable kafka queue depth control.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_qdc_idle_depth

Queue depth when idleness is detected in Kafka queue depth control.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_latency_alpha

Smoothing parameter for Kafka queue depth control latency tracking.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.002`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_max_depth

Maximum queue depth used in Kafka queue depth control.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_max_latency_ms

Maximum latency threshold for Kafka queue depth control depth tracking.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`80` (80 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_qdc_min_depth

Minimum queue depth used in Kafka queue depth control.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_window_count

Number of windows used in Kafka queue depth control latency tracking.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`12`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_qdc_window_size_ms

Window size for Kafka queue depth control latency tracking.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1500` (1500 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== kafka_quota_balancer_min_shard_throughput_bps

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Bytes per second

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== kafka_quota_balancer_min_shard_throughput_ratio

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== kafka_quota_balancer_node_period

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== kafka_quota_balancer_window

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== kafka_request_max_bytes

Maximum size of a single request processed using the Kafka API.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`104857600`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_rpc_server_stream_recv_buf

Maximum size of the user-space receive buffer. If `null`, this limit is not applied.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`65536`

|===


=== kafka_rpc_server_tcp_recv_buf

Size of the Kafka server TCP receive buffer. If `null`, the property is disabled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

| Example
|
`65536`

|===


=== kafka_rpc_server_tcp_send_buf

Size of the Kafka server TCP transmit buffer. If `null`, the property is disabled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

| Example
|
`65536`

|===


=== kafka_sasl_max_reauth_ms

The maximum time between Kafka client reauthentications. If a client has not reauthenticated a connection within this time frame, that connection is torn down.

IMPORTANT: If this property is not set (or set to `null`), session expiry is disabled, and a connection could live long after the client's credentials are expired or revoked.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`1000`

|===


=== kafka_schema_id_validation_cache_capacity

Per-shard capacity of the cache for validating schema IDs.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`128`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_tcp_keepalive_idle_timeout_seconds

TCP keepalive idle timeout in seconds for Kafka connections. This describes the timeout between TCP keepalive probes that the remote site successfully acknowledged. Refers to the TCP_KEEPIDLE socket option. When changed, applies to new connections only.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`120` (2 minutes)
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_tcp_keepalive_probe_interval_seconds

TCP keepalive probe interval in seconds for Kafka connections. This describes the timeout between unacknowledged TCP keepalives. Refers to the TCP_KEEPINTVL socket option. When changed, applies to new connections only.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`60` (1 minute)
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_tcp_keepalive_probes

TCP keepalive unacknowledged probes until the connection is considered dead for Kafka connections. Refers to the TCP_KEEPCNT socket option. When changed, applies to new connections only.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kafka_throughput_control

List of throughput control groups that define exclusions from broker-wide throughput limits. Clients excluded from broker-wide throughput limits are still potentially subject to client-specific throughput limits.

Each throughput control group consists of:

* `name` (optional) - any unique group name
* `client_id` - regex to match client_id

Example values:

* `[{'name': 'first_group','client_id': 'client1'}, {'client_id': 'consumer-\d+'}]`
* `[{'name': 'catch all'}]`
* `[{'name': 'missing_id', 'client_id': '+empty'}]`

A connection is assigned the first matching group and is then excluded from throughput control. A `name` is not required, but can help you categorize the exclusions. Specifying `+empty` for the `client_id` will match on clients that opt not to send a `client_id`. You can also optionally omit the `client_id` and specify only a `name`, as shown. In this situation, all clients will match the rule and Redpanda will exclude them from all from broker-wide throughput control.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`[{'name': 'first_group','client_id': 'client1'}, {'client_id': 'consumer-\d+'}, {'name': 'catch all'}]`

| Related topics
|xref:manage:cluster-maintenance/manage-throughput.adoc[Manage throughput]

|===


=== kafka_throughput_controlled_api_keys

List of Kafka API keys that are subject to cluster-wide and node-wide throughput limit control.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[produce, fetch]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kafka_throughput_limit_node_in_bps

The maximum rate of all ingress Kafka API traffic for a node. Includes all Kafka API traffic (requests, responses, headers, fetched data, produced data, etc.). If `null`, the property is disabled, and traffic is not limited.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-9223372036854776000`, `9223372036854776000`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes per second

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:cluster-maintenance/manage-throughput.adoc#node-wide-throughput-limits[Node-wide throughput limits]

|===


=== kafka_throughput_limit_node_out_bps

The maximum rate of all egress Kafka traffic for a node. Includes all Kafka API traffic (requests, responses, headers, fetched data, produced data, etc.). If `null`, the property is disabled, and traffic is not limited.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-9223372036854776000`, `9223372036854776000`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes per second

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:cluster-maintenance/manage-throughput.adoc#node-wide-throughput-limits[Node-wide throughput limits]

|===


=== kafka_throughput_replenish_threshold

Threshold for refilling the token bucket as part of enforcing throughput limits.

This threshold is evaluated with each request for data. When the number of tokens to replenish exceeds this threshold, then tokens are added to the token bucket. This ensures that the atomic is not being updated for the token count with each request. The range for this threshold is automatically clamped to the corresponding throughput limit for ingress and egress.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-9223372036854776000`, `9223372036854776000`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|
* xref:reference:cluster-properties.adoc#kafka_throughput_limit_node_in_bps[`kafka_throughput_limit_node_in_bps`]

* xref:reference:cluster-properties.adoc#kafka_throughput_limit_node_out_bps[`kafka_throughput_limit_node_out_bps`]

* xref:manage:cluster-maintenance/manage-throughput.adoc[Manage Throughput]

|===


// tag::deprecated[]
=== kafka_throughput_throttling_v2

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== kafka_topics_max

Maximum number of Kafka user topics that can be created. If `null`, then no limit is enforced.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== kvstore_flush_interval

Key-value store flush interval (in milliseconds).

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10 milliseconds`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== kvstore_max_segment_size

Key-value maximum segment size (in bytes).

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`16777216`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== leader_balancer_idle_timeout

Leadership rebalancing idle timeout.

*Unit*: milliseconds

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`120000` (2 minutes)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== leader_balancer_mode

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== leader_balancer_mute_timeout

The length of time that a glossterm:Raft[] group is muted after a leadership rebalance operation. Any group that has been moved, regardless of whether the move succeeded or failed, undergoes a cooling-off period. This prevents Raft groups from repeatedly experiencing leadership rebalance operations in a short time frame, which can lead to instability in the cluster.

The leader balancer maintains a list of muted groups and reevaluates muted status at the start of each balancing iteration. Muted groups still contribute to overall cluster balance calculations although they can't themselves be moved until the mute period is over.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`300000` (5 minutes)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== leader_balancer_node_mute_timeout

The duration after which a broker that hasn't sent a heartbeat is considered muted. This timeout sets a threshold for identifying brokers that shouldn't be targeted for leadership transfers when the cluster rebalances, for example, because of unreliable network connectivity.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`20000` (20 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== leader_balancer_transfer_limit_per_shard

Per shard limit for in-progress leadership transfers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`512`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== legacy_group_offset_retention_enabled

Group offset retention is enabled by default starting in Redpanda version 23.1. To enable offset retention after upgrading from an older version, set this option to true.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== legacy_permit_unsafe_log_operation

Flag to enable a Redpanda cluster operator to use unsafe control characters within strings, such as consumer group names or user names. This flag applies only for Redpanda clusters that were originally on version 23.1 or earlier and have been upgraded to version 23.2 or later. Starting in version 23.2, newly-created Redpanda clusters ignore this property.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== legacy_unsafe_log_warning_interval_sec

Period at which to log a warning about using unsafe strings containing control characters. If unsafe strings are permitted by `legacy_permit_unsafe_log_operation`, a warning will be logged at an interval specified by this property.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`300` (5 minutes)
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== log_cleanup_policy

Default cleanup policy for topic logs.

The topic property xref:./topic-properties.adoc#cleanuppolicy[`cleanup.policy`] overrides the value of `log_cleanup_policy` at the topic level.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`none`, `delete`, `compact`
endif::[]
ifdef::env-cloud[]
`none`, `delete`, `compact`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`delete`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`compact,delete`

| Related topics
|xref:reference:properties/topic-properties.adoc#cleanuppolicy[`cleanup.policy`]

|===


// tag::deprecated[]
=== log_compaction_adjacent_merge_self_compaction_count

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== log_compaction_disable_tx_batch_removal

Prevents log compaction from removing transaction metadata. Only set this to `true` if you experience stability issues related to transaction cleanup during compaction.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== log_compaction_interval_ms

How often to trigger background compaction.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== log_compaction_merge_max_ranges

The maximum range of segments that can be processed in a single round of adjacent segment compaction. If `null` (the default value), no maximum is imposed on the number of ranges that can be processed at once. A value below 1 effectively disables adjacent merge compaction.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== log_compaction_merge_max_segments_per_range

The maximum number of segments that can be combined into a single segment during an adjacent merge operation. If `null` (the default value), no maximum is imposed on the number of segments that can be combined at once. A value below 2 effectively disables adjacent merge compaction.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== log_compaction_pause_use_sliding_window

Pause use of sliding window compaction. Toggle to `true` _only_ when you want to force adjacent segment compaction. The memory reserved by `storage_compaction_key_map_memory` is not freed when this is set to `true`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== log_compaction_tx_batch_removal_enabled

Enables removal of transactional control batches during compaction. These batches are removed according to a topic's configured delete.retention.ms, and only if the topic's cleanup.policy allows compaction.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== log_compaction_use_sliding_window

Use sliding window compaction.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== log_compression_type

IMPORTANT: This property is ignored regardless of the value specified. The behavior is always the same as the `producer` value. Redpanda brokers do not compress or recompress data based on this property. If producers send compressed data, Redpanda stores it as-is; if producers send uncompressed data, Redpanda stores it uncompressed. Other listed values are accepted for Apache Kafka compatibility but are ignored by the broker. This property may appear in Admin API and `rpk topic describe` outputs for compatibility.

Default for the Kafka-compatible compression.type property. Redpanda does not recompress data.

The topic property xref:./topic-properties.adoc#compressiontype[`compression.type`] overrides the value of `log_compression_type` at the topic level.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`none`, `gzip`, `snappy`, `lz4`, `zstd`, `count`, `producer`
endif::[]
ifdef::env-cloud[]
`none`, `gzip`, `snappy`, `lz4`, `zstd`, `count`, `producer`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`producer`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`snappy`

| Related topics
|xref:reference:properties/topic-properties.adoc#compressiontype[`compression.type`]

|===


=== log_disable_housekeeping_for_tests

Disables the housekeeping loop for local storage. This property is used to simplify testing, and should not be set in production.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== log_message_timestamp_after_max_ms

The maximum allowed time difference when a record's timestamp is in the future compared to the broker's clock. For topics using <<log_message_timestamp_type, `CreateTime`>> timestamps, Redpanda rejects records with timestamps that are too far in the future. This property has no effect on topics using <<log_message_timestamp_type, `AppendTime`>> timestamps. The topic property xref:./topic-properties.adoc#messagetimestampaftermaxms[`message.timestamp.after.max.ms`] overrides this cluster-level setting.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3600000` (1 hour)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc#messagetimestampaftermaxms[`message.timestamp.after.max.ms`]

|===


// tag::deprecated[]
=== log_message_timestamp_alert_after_ms

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== log_message_timestamp_alert_before_ms

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== log_message_timestamp_before_max_ms

The maximum allowed time difference when a record's timestamp is in the past compared to the broker's clock. For topics using <<log_message_timestamp_type, `CreateTime`>> timestamps, Redpanda rejects records with timestamps that are too far in the past. This property has no effect on topics using <<log_message_timestamp_type, `AppendTime`>> timestamps. The topic property xref:./topic-properties.adoc#messagetimestampbeforemaxms[`message.timestamp.before.max.ms`] overrides this cluster-level setting.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`9223372036854`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc#messagetimestampbeforemaxms[`message.timestamp.before.max.ms`]

|===


=== log_message_timestamp_type

Default timestamp type for topic messages (CreateTime or LogAppendTime).

The topic property xref:./topic-properties.adoc#messagetimestamptype[`message.timestamp.type`] overrides the value of `log_message_timestamp_type` at the topic level.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`CreateTime`, `LogAppendTime`
endif::[]
ifdef::env-cloud[]
`CreateTime`, `LogAppendTime`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`CreateTime`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`LogAppendTime`

| Related topics
|xref:reference:properties/topic-properties.adoc#messagetimestamptype[`message.timestamp.type`]

|===


=== log_retention_ms

The amount of time to keep a log file before deleting it (in milliseconds). If set to `-1`, no time limit is applied. This is a cluster-wide default when a topic does not set or disable xref:./topic-properties.adoc#retentionms[`retention.ms`].

[cols="1s,2a"]
|===
| Property | Value

| Type
| `retention_duration_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`604800000` (1 week)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Aliases
| `delete_retention_ms`
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc#retentionms[`retention.ms`]

|===


// tag::redpanda-cloud[]
=== log_segment_ms

Default lifetime of log segments. If `null`, the property is disabled, and no default lifetime is set. Any value under 60 seconds (60000 ms) is rejected. This property can also be set in the Kafka API using the Kafka-compatible alias, `log.roll.ms`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`2 weeks`
endif::[]

| Nullable
| Yes

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`3600000`

ifndef::env-cloud[]
| Related topics
|xref:reference:properties/topic-properties.adoc#segmentms[`segment.ms`]
endif::[]

|===

// end::redpanda-cloud[]

=== log_segment_ms_max

Upper bound on topic `segment.ms`: higher values will be clamped to this value.

*Unit*: milliseconds

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`31536000000` (1 year)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`31536000000`

|===


=== log_segment_ms_min

Lower bound on topic `segment.ms`: lower values will be clamped to this value.

*Unit*: milliseconds

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`600000` (10 minutes)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`600000`

|===


=== log_segment_size

Default log segment size in bytes for topics which do not set `segment.bytes`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`134217728`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`2147483648`

|===


=== log_segment_size_jitter_percent

Random variation to the segment size limit used for each partition.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `65535`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5`
endif::[]

| Nullable
| No

| Unit
| Percent

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`2`

|===


=== log_segment_size_max

Upper bound on topic `segment.bytes`: higher values will be clamped to this limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`268435456`

|===


=== log_segment_size_min

Lower bound on topic `segment.bytes`: lower values will be clamped to this limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1048576`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`16777216`

|===


=== lz4_decompress_reusable_buffers_disabled

Disable reusable preallocated buffers for LZ4 decompression.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== max_compacted_log_segment_size

Maximum compacted segment size after consolidation.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`536870912`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`10737418240`

|===


=== max_compaction_lag_ms

For a compacted topic, the maximum time a message remains ineligible for compaction. The topic property `max.compaction.lag.ms` overrides this property.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`9223372036854`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc#max.compaction.lag.ms[`max.compaction.lag.ms`]

|===


=== max_concurrent_producer_ids

Maximum number of active producer sessions per shard. Each shard tracks producer IDs using an LRU (Least Recently Used) eviction policy. When the configured limit is exceeded, the least recently used producer IDs are evicted from the cache.

If you upgrade from 23.2.x to 23.3.x and encounter `OUT_OF_SEQUENCE` errors, consider increasing this value. In 23.3.x, the configuration changed from a per-partition basis to a per-shard basis.

IMPORTANT: The default value is unlimited, which can lead to unbounded memory growth and out-of-memory (OOM) crashes in production environments with heavy producer usage, especially when using transactions or idempotent producers. Set a reasonable limit in production deployments.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`Maximum value`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|
* xref:develop:transactions.adoc#tune-producer-id-limits[Tune producer ID limits]

* xref:reference:properties/cluster-properties.adoc#transactional_id_expiration_ms[transactional_id_expiration_ms]

* xref:manage:monitoring.adoc[Monitor Redpanda]

|===


=== max_in_flight_pandaproxy_requests_per_shard

Maximum number of in-flight HTTP requests to HTTP Proxy permitted per shard.  Any additional requests above this limit will be rejected with a 429 error.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`500`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== max_in_flight_schema_registry_requests_per_shard

Maximum number of in-flight HTTP requests to Schema Registry permitted per shard.  Any additional requests above this limit will be rejected with a 429 error.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`500`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== max_kafka_throttle_delay_ms

Fail-safe maximum throttle delay on Kafka requests.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== max_transactions_per_coordinator

Specifies the maximum number of active transaction sessions per coordinator. When the threshold is passed Redpanda terminates old sessions. When an idle producer corresponding to the terminated session wakes up and produces, it leads to its batches being rejected with invalid producer epoch or invalid_producer_id_mapping error (depends on the transaction execution phase).

For details, see xref:develop:transactions#transaction-usage-tips[Transaction usage tips].

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`Maximum value`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Related topics
|xref:develop:transactions#transaction-usage-tips[Transaction usage tips]

|===


// tag::deprecated[]
=== max_version

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== members_backend_retry_ms

Time between members backend reconciliation loop retries.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== memory_abort_on_alloc_failure

If `true`, the Redpanda process will terminate immediately when an allocation cannot be satisfied due to memory exhaustion. If false, an exception is thrown.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== metadata_dissemination_interval_ms

Interval for metadata dissemination batching.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000` (3 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`5000`

|===


=== metadata_dissemination_retries

Number of attempts to look up a topic's metadata-like shard before a request fails. This configuration controls the number of retries that request handlers perform when internal topic metadata (for topics like tx, consumer offsets, etc) is missing. These topics are usually created on demand when users try to use the cluster for the first time and it may take some time for the creation to happen and the metadata to propagate to all the brokers (particularly the broker handling the request). In the meantime Redpanda waits and retries. This configuration controls the number retries.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== metadata_dissemination_retry_delay_ms

Delay before retrying a topic lookup in a shard or other meta tables.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`500` (500 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== metadata_status_wait_timeout_ms

Maximum time to wait in metadata request for cluster health to be refreshed.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`2000` (2 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== metrics_reporter_report_interval

Cluster metrics reporter report interval.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`86400000` (1 day)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== metrics_reporter_tick_interval

Cluster metrics reporter tick interval.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`60000` (1 minute)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== metrics_reporter_url

URL of the cluster metrics reporter.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`https://m.rp.vectorized.io/v2`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== min_cleanable_dirty_ratio

The minimum ratio between the number of bytes in dirty segments and the total number of bytes in closed segments that must be reached before a partition's log is eligible for compaction in a compact topic. The topic property `min.cleanable.dirty.ratio` overrides this value at the topic level.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.2`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`0.2`

|===


=== min_compaction_lag_ms

The minimum amount of time (in ms) that a log segment must remain unaltered before it can be compacted in a compact topic.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0` (0 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc#min.compaction.lag.ms[`min.compaction.lag.ms`]

|===


// tag::deprecated[]
=== min_version

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== minimum_topic_replication

Minimum allowable replication factor for topics in this cluster. The set value must be positive, odd, and equal to or less than the number of available brokers. Changing this parameter only restricts newly-created topics. Redpanda returns an `INVALID_REPLICATION_FACTOR` error on any attempt to create a topic with a replication factor less than this property. If you change the `minimum_topic_replications` setting, the replication factor of existing topics remains unchanged. However, Redpanda will log a warning on start-up with a list of any topics that have fewer replicas than this minimum. For example, you might see a message such as `Topic X has a replication factor less than specified minimum: 1 < 3`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== node_isolation_heartbeat_timeout

How long after the last heartbeat request a node will wait before considering itself to be isolated.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-9223372036854776000`, `9223372036854776000`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== node_management_operation_timeout_ms

Timeout for executing node management operations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== node_status_interval

Time interval between two node status messages. Node status messages establish liveness status outside of the Raft protocol.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100` (100 milliseconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== node_status_reconnect_max_backoff_ms

Maximum backoff (in milliseconds) to reconnect to an unresponsive peer during node status liveness checks.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`15000` (15 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== oidc_clock_skew_tolerance

The amount of time (in seconds) to allow for when validating the expiry claim in the token.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== oidc_discovery_url

The URL pointing to the well-known discovery endpoint for the OIDC provider.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`https://auth.prd.cloud.redpanda.com/.well-known/openid-configuration`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== oidc_keys_refresh_interval

The frequency of refreshing the JSON Web Keys (JWKS) used to validate access tokens.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3600` (1 hour)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== oidc_principal_mapping

Rule for mapping JWT payload claim to a Redpanda user principal.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`$.sub`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|
* xref:manage:security/authentication.adoc#oidc[OpenID Connect authentication]

ifndef::env-cloud[]
* xref:manage:kubernetes/security/authentication/k-authentication.adoc[OpenID Connect authentication in Kubernetes]
endif::[]

|===

// end::redpanda-cloud[]

// tag::redpanda-cloud[]
=== oidc_token_audience

A string representing the intended recipient of the token.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`redpanda`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== partition_autobalancing_concurrent_moves

Number of partitions that can be reassigned at once.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`50`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== partition_autobalancing_max_disk_usage_percent

NOTE: This property applies only when <<partition_autobalancing_mode,`partition_autobalancing_mode`>> is set to `continuous`.

When the disk usage of a node exceeds this threshold, it triggers Redpanda to move partitions off of the node.

*Unit*: percent of disk used

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`80`
endif::[]

| Nullable
| No

| Unit
| Percent

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:cluster-maintenance/continuous-data-balancing.adoc[Configure Continuous Data Balancing]

|===


=== partition_autobalancing_min_size_threshold

Minimum size of partition that is going to be prioritized when rebalancing a cluster due to the disk size threshold being breached. This value is calculated automatically by default.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== partition_autobalancing_mode

Controls when and how Redpanda automatically rebalances partition replicas across brokers. For more information, see xref:manage:cluster-maintenance/cluster-balancing.adoc[partition balancing].

Values:

* `continuous`: Partition balancing happens automatically to maintain optimal performance and availability, based on continuous monitoring for node changes (same as `node_add`) and also high disk usage. This option requires an enterprise license, and it is customized by xref:reference:properties/cluster-properties.adoc#partition_autobalancing_node_availability_timeout_sec[`partition_autobalancing_node_availability_timeout_sec`] and xref:reference:properties/cluster-properties.adoc#partition_autobalancing_max_disk_usage_percent[`partition_autobalancing_max_disk_usage_percent`] properties.
* `node_add`: Partition balancing happens when a node is added.
* `off`: Partition balancing is disabled. This option is not recommended for production clusters.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
*License-based defaults:*

* *Community:* `node_add` (if no Enterprise license is present)
* *Enterprise:* `continuous` (if an Enterprise license is present)

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`off`, `node_add`, `continuous` (Enterprise)
endif::[]
ifdef::env-cloud[]
`off`, `node_add`, `continuous`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`continuous`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`node_add`

| Related topics
|
* xref:manage:cluster-maintenance/cluster-balancing.adoc[partition balancing]

* xref:manage:cluster-maintenance/continuous-data-balancing.adoc[Configure Continuous Data Balancing]

* xref:get-started:licensing/index.adoc[enterprise license]

|===


// tag::deprecated[]
=== partition_autobalancing_movement_batch_size_bytes

Total size of partitions that autobalancer is going to move in one batch (deprecated, use partition_autobalancing_concurrent_moves to limit the autobalancer concurrency)

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5368709120`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Deprecated
endif::[]

|===

// end::deprecated[]

=== partition_autobalancing_node_availability_timeout_sec

When a node is unavailable for at least this timeout duration, it triggers Redpanda to move partitions off of the node. This property applies only when `partition_autobalancing_mode` is set to `continuous`.      

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`900` (15 minutes)
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:cluster-maintenance/continuous-data-balancing.adoc[Configure Continuous Data Balancing]

|===


=== partition_autobalancing_tick_interval_ms

Partition autobalancer tick interval.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== partition_autobalancing_tick_moves_drop_threshold

If the number of scheduled tick moves drops by this ratio, a new tick is scheduled immediately. Valid values are (0, 1]. For example, with a value of 0.2 and 100 scheduled moves in a tick, a new tick is scheduled when the in-progress moves are fewer than 80.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0.2`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== partition_autobalancing_topic_aware

If `true`, Redpanda prioritizes balancing a topic’s partition replica count evenly across all brokers while it’s balancing the cluster’s overall partition count. Because different topics in a cluster can have vastly different load profiles, this better distributes the workload of the most heavily-used topics evenly across brokers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== partition_manager_shutdown_watchdog_timeout

A threshold value to detect partitions which might have been stuck while shutting down. After this threshold, a watchdog in partition manager will log information about partition shutdown not making progress.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== pp_sr_smp_max_non_local_requests

Maximum number of Cross-core(Inter-shard communication) requests pending in HTTP Proxy and Schema Registry seastar::smp group. (For more details, see the `seastar::smp_service_group` documentation).

See https://docs.seastar.io/master/[Seastar documentation^]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== quota_manager_gc_sec

Quota manager GC frequency in milliseconds.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000 milliseconds`
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_election_timeout_ms

Election timeout expressed in milliseconds.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1500` (1500 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_enable_longest_log_detection

Enables an additional step in leader election where a candidate is allowed to wait for all the replies from the broker it requested votes from. This may introduce a small delay when recovering from failure, but it prevents truncation if any of the replicas have more data than the majority.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_enable_lw_heartbeat

Enables Raft optimization of heartbeats.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== raft_flush_timer_interval_ms

Interval of checking partition against the `raft_replica_max_pending_flush_bytes`, deprecated started 24.1, use raft_replica_max_flush_delay_ms instead 

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100` (100 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Deprecated
endif::[]

|===

// end::deprecated[]

=== raft_heartbeat_disconnect_failures

The number of failed heartbeats after which an unresponsive TCP connection is forcibly closed. To disable forced disconnection, set to 0.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_heartbeat_interval_ms

Number of milliseconds for Raft leader heartbeats.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`150 milliseconds`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_heartbeat_timeout_ms

Raft heartbeat RPC (remote procedure call) timeout. Raft uses a heartbeat mechanism to maintain leadership authority and to trigger leader elections. The `raft_heartbeat_interval_ms` is a periodic heartbeat sent by the partition leader to all followers to declare its leadership. If a follower does not receive a heartbeat within the `raft_heartbeat_timeout_ms`, then it triggers an election to choose a new partition leader.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000` (3 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_io_timeout_ms

Raft I/O timeout.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_learner_recovery_rate

Raft learner recovery rate limit. Throttles the rate of data communicated to nodes (learners) that need to catch up to leaders. This rate limit is placed on a node sending data to a recovering node. Each sending node is limited to this rate. The recovering node accepts data as fast as possible according to the combined limits of all healthy nodes in the cluster. For example, if two nodes are sending data to the recovering node, and `raft_learner_recovery_rate` is 100 MB/sec, then the recovering node will recover at a rate of 200 MB/sec.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`104857600`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_max_buffered_follower_append_entries_bytes_per_shard

The total size of append entry requests that may be cached per shard, using the Raft-buffered protocol. When an entry is cached, the leader can continue serving requests because the ordering of the cached requests cannot change. When the total size of cached requests reaches the set limit, back pressure is applied to throttle producers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== raft_max_concurrent_append_requests_per_follower

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== raft_max_inflight_follower_append_entries_requests_per_shard

The maximum number of append entry requests that may be sent from Raft groups on a Seastar shard to the current node, and are awaiting a reply. This property replaces `raft_max_concurrent_append_requests_per_follower`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1024`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_max_recovery_memory

Maximum memory that can be used for reads in Raft recovery process by default 15% of total memory.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`41943040`

|===


=== raft_recovery_concurrency_per_shard

Number of partitions that may simultaneously recover data to a particular shard. This number is limited to avoid overwhelming nodes when they come back online after an outage.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`64`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== raft_recovery_default_read_size

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== raft_recovery_throttle_disable_dynamic_mode

include::reference:partial$internal-use-property.adoc[]

Disables cross shard sharing used to throttle recovery traffic. Should only be used to debug unexpected problems.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_replica_max_flush_delay_ms

Maximum delay between two subsequent flushes. After this delay, the log is automatically force flushed.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`100` (100 milliseconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_replica_max_pending_flush_bytes

Maximum number of bytes that are not flushed per partition. If the configured threshold is reached, the log is automatically flushed even if it has not been explicitly requested.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`262144`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_replicate_batch_window_size

Maximum size of requests cached for replication.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1048576`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_smp_max_non_local_requests

Maximum number of Cross-core(Inter-shard communication) requests pending in Raft seastar::smp group. For details, refer to the `seastar::smp_service_group` documentation).

See https://docs.seastar.io/master/[Seastar documentation^]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_timeout_now_timeout_ms

Timeout for Raft's timeout_now RPC. This RPC is used to force a follower to dispatch a round of votes immediately.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000` (1 second)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== raft_transfer_leader_recovery_timeout_ms

Follower recovery timeout waiting period when transferring leadership.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== readers_cache_eviction_timeout_ms

Duration after which inactive readers are evicted from cache.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== readers_cache_target_max_size

Maximum desired number of readers cached per NTP. This a soft limit, meaning that a number of readers in cache may temporarily increase as cleanup is performed in the background.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`200`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== reclaim_batch_cache_min_free

Minimum amount of free memory maintained by the batch cache background reclaimer.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`67108864`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== reclaim_growth_window

Starting from the last point in time when memory was reclaimed from the batch cache, this is the duration during which the amount of memory to reclaim grows at a significant rate, based on heuristics about the amount of available memory.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000` (3 seconds)
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== reclaim_max_size

Maximum batch cache reclaim size.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`4194304`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== reclaim_min_size

Minimum batch cache reclaim size.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`131072`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== reclaim_stable_window

If the duration since the last time memory was reclaimed is longer than the amount of time specified in this property, the memory usage of the batch cache is considered stable, so only the minimum size (<<reclaim_min_size,`reclaim_min_size`>>) is set to be reclaimed.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== recovery_append_timeout_ms

Timeout for append entry requests issued while updating a stale follower.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== release_cache_on_segment_roll

Flag for specifying whether or not to release cache when a full segment is rolled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== replicate_append_timeout_ms

Timeout for append entry requests issued while replicating entries.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3000` (3 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== retention_bytes

Default maximum number of bytes per partition on disk before triggering deletion of the oldest messages. If `null` (the default value), no limit is applied.

The topic property xref:./topic-properties.adoc#retentionbytes[`retention.bytes`] overrides the value of `retention_bytes` at the topic level.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/topic-properties.adoc#retentionbytes[`retention.bytes`]

|===


=== retention_local_strict

Flag to allow Tiered Storage topics to expand to consumable retention policy limits. When this flag is enabled, non-local retention settings are used, and local retention settings are used to inform data removal policies in low-disk space scenarios.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== retention_local_strict_override

Trim log data when a cloud topic reaches its local retention limit. When this option is disabled Redpanda will allow partitions to grow past the local retention limit, and will be trimmed automatically as storage reaches the configured target size.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== retention_local_target_bytes_default

Local retention size target for partitions of topics with object storage write enabled. If `null`, the property is disabled.

This property can be overridden on a per-topic basis by setting `retention.local.target.bytes` in each topic enabled for Tiered Storage. See xref:manage:cluster-maintenance/disk-utilization.adoc#configure-message-retention[Configure message retention].

NOTE: Both `retention_local_target_bytes_default` and `retention_local_target_ms_default` can be set. The limit that is reached earlier is applied.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:cluster-maintenance/disk-utilization.adoc#configure-message-retention[Configure message retention]

|===


=== retention_local_target_capacity_bytes

The target capacity (in bytes) that log storage will try to use before additional retention rules take over to trim data to meet the target. When no target is specified, storage usage is unbounded.

NOTE: Redpanda Data recommends setting only one of <<retention_local_target_capacity_bytes,`retention_local_target_capacity_bytes`>> or <<retention_local_target_capacity_percent,`retention_local_target_capacity_percent`>>. If both are set, the minimum of the two is used as the effective target capacity.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`2147483648000`

|===


=== retention_local_target_capacity_percent

The target capacity in percent of unreserved space (<<disk_reservation_percent,`disk_reservation_percent`>>) that log storage will try to use before additional retention rules will take over to trim data in order to meet the target. When no target is specified storage usage is unbounded.

NOTE: Redpanda Data recommends setting only one of <<retention_local_target_capacity_bytes,`retention_local_target_capacity_bytes`>> or <<retention_local_target_capacity_percent,`retention_local_target_capacity_percent`>>. If both are set, the minimum of the two is used as the effective target capacity.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`80`
endif::[]

| Nullable
| Yes

| Unit
| Percent

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`80.0`

|===


=== retention_local_target_ms_default

Local retention time target for partitions of topics with object storage write enabled.

This property can be overridden on a per-topic basis by setting `retention.local.target.ms` in each topic enabled for Tiered Storage. See xref:manage:cluster-maintenance/disk-utilization.adoc#configure-message-retention[Configure message retention].

NOTE: Both <<retention_local_target_bytes_default,`retention_local_target_bytes_default`>> and <<retention_local_target_ms_default,`retention_local_target_ms_default`>> can be set. The limit that is reached first is applied.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`86400000` (1 day)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:cluster-maintenance/disk-utilization.adoc#configure-message-retention[Configure message retention]

|===


=== retention_local_trim_interval

The period during which disk usage is checked for disk pressure, and data is optionally trimmed to meet the target.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`30000` (30 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`31536000000`

|===


=== retention_local_trim_overage_coeff

The space management control loop reclaims the overage multiplied by this this coefficient to compensate for data that is written during the idle period between control loop invocations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`2`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`1.8`

|===


=== rm_sync_timeout_ms

Resource manager's synchronization timeout. Specifies the maximum time for this node to wait for the internal state machine to catch up with all events written by previous leaders before rejecting a request.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::deprecated[]
=== rm_violation_recovery_policy

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== rpc_client_connections_per_peer

The maximum number of connections a broker will open to each of its peers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`128`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

| Example
|
`8`

|===


=== rpc_server_compress_replies

Enable compression for internal RPC (remote procedure call) server replies.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== rpc_server_listen_backlog

Maximum TCP connection queue length for Kafka server and internal RPC server. If `null` (the default value), no queue length is set.

*Unit*: number of queue entries

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== rpc_server_tcp_recv_buf

Internal RPC TCP receive buffer size. If `null` (the default value), no buffer size is set by Redpanda.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

| Example
|
`65536`

|===


=== rpc_server_tcp_send_buf

Internal RPC TCP send buffer size. If `null` (the default value), then no buffer size is set by Redpanda.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

| Example
|
`65536`

|===


=== rpk_path

Path to RPK binary.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`/usr/bin/rpk`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== rps_limit_acls_and_users_operations

Rate limit for controller ACLs and user's operations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== rps_limit_configuration_operations

Rate limit for controller configuration operations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== rps_limit_move_operations

Rate limit for controller move operations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== rps_limit_node_management_operations

Rate limit for controller node management operations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== rps_limit_topic_operations

Rate limit for controller topic operations.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== sampled_memory_profile

When `true`, memory allocations are sampled and tracked. A sampled live set of allocations can then be retrieved from the Admin API. Additionally, Redpanda will periodically log the top-n allocation sites.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== sasl_kerberos_config

The location of the Kerberos `krb5.conf` file for Redpanda.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`/etc/krb5.conf`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== sasl_kerberos_keytab

The location of the Kerberos keytab file for Redpanda.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`/var/lib/redpanda/redpanda.keytab`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== sasl_kerberos_principal

The primary of the Kerberos Service Principal Name (SPN) for Redpanda.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`redpanda`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== sasl_kerberos_principal_mapping

Rules for mapping Kerberos principal names to Redpanda user principals.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[DEFAULT]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::redpanda-cloud[]
=== sasl_mechanisms

A list of supported SASL mechanisms. Accepted values: `SCRAM`, `GSSAPI`, `OAUTHBEARER`, `PLAIN`.  Note that in order to enable PLAIN, you must also enable SCRAM.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
This property requires an Enterprise license to use.

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array` (enum)


| Accepted values
|
ifndef::env-cloud[]
`GSSAPI` (Enterprise), `SCRAM`, `OAUTHBEARER` (Enterprise), `PLAIN`
endif::[]
ifdef::env-cloud[]
`GSSAPI`, `SCRAM`, `OAUTHBEARER`, `PLAIN`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`SCRAM`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== sasl_mechanisms_overrides

Configure different SASL authentication mechanisms for specific listeners. This overrides the cluster-wide <<sasl_mechanisms, `sasl_mechanisms`>> setting for the specified listener. Use this when you need different authentication methods on different listeners, such as SCRAM for internal traffic and OAUTHBEARER for external clients. The same requirements from `sasl_mechanisms` apply.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
This property requires an Enterprise license to use.

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`[{'listener':'kafka_listener', 'sasl_mechanisms':['SCRAM']}]`

|===


=== schema_registry_always_normalize

Always normalize schemas. If set, this overrides the `normalize` parameter in requests to the Schema Registry API.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

ifndef::env-cloud[]
| Aliases
| `schema_registry_normalize_on_startup`
endif::[]

|===


// tag::redpanda-cloud[]
=== schema_registry_enable_authorization

Enables ACL-based authorization for Schema Registry requests. When `true`, Schema Registry
uses ACL-based authorization instead of the default `public/user/superuser` authorization model.

ifndef::env-cloud[]
.Enterprise license required
[NOTE]
====
The following values require an Enterprise license: `true`

For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing].
====
endif::[]

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (editable)
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

// tag::deprecated[]
=== schema_registry_protobuf_renderer_v2

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== seed_server_meta_topic_partitions

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Number of partitions per topic

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== segment_appender_flush_timeout_ms

Maximum delay until buffered data is written.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1 second`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== segment_fallocation_step

Size for segments fallocation.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`33554432`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`32768`

|===


// tag::deprecated[]
=== seq_table_min_size

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== space_management_enable

Option to explicitly disable automatic disk space management. If this property was explicitly disabled while using v23.2, it will remain disabled following an upgrade.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== space_management_enable_override

Enable automatic space management. This option is ignored and deprecated in versions >= v23.3.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== space_management_max_log_concurrency

Maximum parallel logs inspected during space management process.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `65535`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`20`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`20`

|===


=== space_management_max_segment_concurrency

Maximum parallel segments inspected during space management process.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `65535`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`10`

|===


=== storage_compaction_index_memory

Maximum number of bytes that may be used on each shard by compaction index writers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`134217728`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`1073741824`

|===


=== storage_compaction_key_map_memory

Maximum number of bytes that may be used on each shard by compaction key-offset maps. Only applies when <<log_compaction_use_sliding_window,`log_compaction_use_sliding_window`>> is set to `true`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`134217728`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`1073741824`

|===


=== storage_compaction_key_map_memory_limit_percent

Limit on <<storage_compaction_key_map_memory,`storage_compaction_key_map_memory`>>, expressed as a percentage of memory per shard, that bounds the amount of memory used by compaction key-offset maps. 

NOTE: Memory per shard is computed after <<data_transforms_per_core_memory_reservation,`data_transforms_per_core_memory_reservation`>>, and only applies when <<log_compaction_use_sliding_window,`log_compaction_use_sliding_window`>> is set to `true`.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `number`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`12`
endif::[]

| Nullable
| No

| Unit
| Percent

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`12.0`

|===


=== storage_ignore_cstore_hints

When set, cstore hints are ignored and not used for data access (but are otherwise generated).

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== storage_ignore_timestamps_in_future_sec

The maximum number of seconds that a record's timestamp can be ahead of a Redpanda broker's clock and still be used when deciding whether to clean up the record for data retention. This property makes possible the timely cleanup of records from clients with clocks that are drastically unsynchronized relative to Redpanda.

When determining whether to clean up a record with timestamp more than `storage_ignore_timestamps_in_future_sec` seconds ahead of the broker, Redpanda ignores the record's timestamp and instead uses a valid timestamp of another record in the same segment, or (if another record's valid timestamp is unavailable) the timestamp of when the segment file was last modified (mtime).

By default, `storage_ignore_timestamps_in_future_sec` is disabled (null).

[TIP]
====
To figure out whether to set `storage_ignore_timestamps_in_future_sec` for your system:

. Look for logs with segments that are unexpectedly large and not being cleaned up.
. In the logs, search for records with unsynchronized timestamps that are further into the future than tolerable by your data retention and storage settings. For example, timestamps 60 seconds or more into the future can be considered to be too unsynchronized.
. If you find unsynchronized timestamps throughout your logs, determine the number of seconds that the timestamps are ahead of their actual time, and set `storage_ignore_timestamps_in_future_sec` to that value so data retention can proceed.
. If you only find unsynchronized timestamps that are the result of transient behavior, you can disable `storage_ignore_timestamps_in_future_sec`.
====

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`3600`

|===


=== storage_max_concurrent_replay

Maximum number of partitions' logs that will be replayed concurrently at startup, or flushed concurrently on shutdown.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1024`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`2048`

|===


=== storage_min_free_bytes

Threshold of minimum bytes free space before rejecting producers.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5368709120`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== storage_read_buffer_size

Size of each read buffer (one per in-flight read, per log segment).

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`131072`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`31768`

|===


=== storage_read_readahead_count

How many additional reads to issue ahead of current read location.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`1`

|===


=== storage_reserve_min_segments

The number of segments per partition that the system will attempt to reserve disk capacity for. For example, if the maximum segment size is configured to be 100 MB, and the value of this option is 2, then in a system with 10 partitions Redpanda will attempt to reserve at least 2 GB of disk space.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-32768`, `32767`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`2`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`4`

|===


=== storage_space_alert_free_threshold_bytes

Threshold of minimum bytes free space before setting storage space alert.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== storage_space_alert_free_threshold_percent

Threshold of minimum percent free space before setting storage space alert.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5`
endif::[]

| Nullable
| No

| Unit
| Percent

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== storage_strict_data_init

Requires that an empty file named `.redpanda_data_dir` be present in the xref:reference:properties/broker-properties.adoc#data_directory[`data_ directory`]. If set to `true`, Redpanda will refuse to start if the file is not found in the data directory.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:reference:properties/broker-properties.adoc#data_directory[`data_ directory`]

|===


=== storage_target_replay_bytes

Target bytes to replay from disk on startup after clean shutdown: controls frequency of snapshots and checkpoints.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10737418240`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`2147483648`

|===


=== superusers

List of superuser usernames.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `array`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`[]`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::deprecated[]
=== target_fetch_quota_byte_rate

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== target_quota_byte_rate

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== tls_certificate_name_format

The format of the certificates's distinguished name to use for mTLS principal mapping. The `legacy` format would appear as 'C=US,ST=California,L=San Francisco,O=Redpanda,CN=redpanda', while the `rfc2253` format would appear as 'CN=redpanda,O=Redpanda,L=San Francisco,ST=California,C=US'.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`legacy`, `rfc2253`
endif::[]
ifdef::env-cloud[]
`legacy`, `rfc2253`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`legacy`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== tls_enable_renegotiation

TLS client-initiated renegotiation is considered unsafe and is disabled by default . Only re-enable it if you are experiencing issues with your TLS-enabled client. This option has no effect on TLSv1.3 connections as client-initiated renegotiation was removed.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::redpanda-cloud[]
=== tls_min_version

The minimum TLS version that Redpanda clusters support. This property prevents client applications from negotiating a downgrade to the TLS version when they make a connection to a Redpanda cluster.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`v1.0`, `v1.1`, `v1.2`, `v1.3`
endif::[]
ifdef::env-cloud[]
`v1.0`, `v1.1`, `v1.2`, `v1.3`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console (read-only)
endif::[]
ifndef::env-cloud[]
`v1.2`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===

// end::redpanda-cloud[]

=== tls_v1_2_cipher_suites

The encryption algorithms available for TLS 1.2 client connections, specified as a colon-separated list in OpenSSL format. Use this to support older clients that require specific encryption methods.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:AES256-GCM-SHA384:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:AES128-SHA:AES128-CCM:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:AES256-SHA:AES256-CCM`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== tls_v1_3_cipher_suites

The encryption algorithms available for TLS 1.3 client connections, specified as a colon-separated list in OpenSSL format. Most deployments don't need to change this. Only modify it to meet specific organizational security requirements.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_CCM_SHA256`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== tm_sync_timeout_ms

Transaction manager's synchronization timeout. Maximum time to wait for internal state machine to catch up before rejecting a request.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10000` (10 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


// tag::deprecated[]
=== tm_violation_recovery_policy

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== tombstone_retention_ms

The retention time for tombstone records in a compacted topic. Cannot be enabled at the same time as any of `cloud_storage_enabled`, `cloud_storage_enable_remote_read`, or `cloud_storage_enable_remote_write`. A typical default setting is `86400000`, or 24 hours.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|xref:manage:cluster-maintenance/compaction-settings.adoc#tombstone-record-removal[Tombstone record removal]

|===


=== topic_fds_per_partition

File descriptors required per partition replica. If topic creation results in the ratio of file descriptor limit to partition replicas being lower than this value, creation of new topics is fails.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== topic_label_aggregation_limit

When the number of topics exceeds this limit, the topic label in generated metrics will be aggregated. If `null`, then there is no limit.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== topic_memory_per_partition

Required memory in bytes per partition replica when creating or altering topics. The total size of the memory pool for partitions is the total memory available to Redpanda times `topic_partitions_memory_allocation_percent`. Each partition created requires `topic_memory_per_partition` bytes from that pool. If insufficient memory is available, creating or altering topics fails.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`DEFAULT_TOPIC_MEMORY_PER_PARTITION`
endif::[]

| Nullable
| Yes

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== topic_partitions_memory_allocation_percent

Percentage of total memory to reserve for topic partitions. See <<topic_memory_per_partition, `topic_memory_per_partition`>> for details.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10`
endif::[]

| Nullable
| No

| Unit
| Percent

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== topic_partitions_per_shard

Maximum number of partition replicas per shard. If topic creation results in the ratio of partition replicas to shards being higher than this value, creation of new topics fails.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== topic_partitions_reserve_shard0

Reserved partition slots on shard (CPU core) 0 on each node.  If this is greater than or equal to <<topic_partitions_per_core,`topic_partitions_per_core`>>, no data partitions will be scheduled on shard 0.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `4294967295`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`0`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== transaction_coordinator_cleanup_policy

Cleanup policy for a transaction coordinator topic.

*Accepted values:*

* `compact`
* `delete`
* `["compact","delete"]`
* `none`

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`none`, `delete`, `compact`
endif::[]
ifdef::env-cloud[]
`none`, `delete`, `compact`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`delete`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`compact,delete`

|===


=== transaction_coordinator_delete_retention_ms

Delete segments older than this age. To ensure transaction state is retained for as long as the longest-running transaction, make sure this is greater than or equal to <<transactional_id_expiration_ms,`transactional_id_expiration_ms`>>.

For example, if your typical transactions run for one hour, consider setting both `transaction_coordinator_delete_retention_ms` and `transactional_id_expiration_ms` to at least 3600000 (one hour), or a little over.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`604800000` (1 week)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== transaction_coordinator_log_segment_size

The size (in bytes) each log segment should be.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1073741824`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== transaction_coordinator_partitions

Number of partitions for transactions coordinator.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-2147483648`, `2147483647`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`50`
endif::[]

| Nullable
| No

| Unit
| Number of partitions per topic

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== transaction_coordinator_replication

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== transaction_max_timeout_ms

The maximum allowed timeout for transactions. If a client-requested transaction timeout exceeds this configuration, the broker returns an error during transactional producer initialization. This guardrail prevents hanging transactions from blocking consumer progress.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`900000` (15 minutes)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== transactional_id_expiration_ms

Expiration time of producer IDs for both transactional and idempotent producers. Despite the name, this setting applies to all producer types. Measured starting from the time of the last write until now for a given ID.

Producer IDs are automatically removed from memory when they expire, which helps manage memory usage. However, this natural cleanup may not be sufficient for workloads with high producer churn rates. Tune this value based on your application's producer session and transaction lifetimes. Consider your longest-running transaction duration plus a buffer to avoid premature expiration.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`604800000` (1 week)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Related topics
|
* xref:develop:transactions.adoc#tune-producer-id-limits[Tune producer ID limits]

* xref:reference:properties/cluster-properties.adoc#max_concurrent_producer_ids[`max_concurrent_producer_ids`]

|===


// tag::deprecated[]
=== tx_log_stats_interval_s

How often to log per partition tx stats, works only with debug logging enabled.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`10` (10 seconds)
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Deprecated
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== tx_registry_log_capacity

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

// tag::deprecated[]
=== tx_registry_sync_timeout_ms

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== tx_timeout_delay_ms

Delay before scheduling the next check for timed out transactions.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`1000` (1 second)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== unsafe_enable_consumer_offsets_delete_retention

Enables delete retention of consumer offsets topic. This is an internal-only configuration and should be enabled only after consulting with Redpanda support.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

|===


=== usage_disk_persistance_interval_sec

The interval in which all usage stats are written to disk.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`300 seconds`
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`300`

|===


=== usage_num_windows

The number of windows to persist in memory and disk.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`24`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`24`

|===


=== usage_window_width_interval_sec

The width of a usage window, tracking cloud and kafka ingress/egress traffic each interval.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17179869184`, `17179869183`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`3600 seconds`
endif::[]

| Nullable
| No

| Unit
| Seconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

| Example
|
`3600`

|===


=== use_fetch_scheduler_group

Use a separate scheduler group for fetch processing.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== use_kafka_handler_scheduler_group

Use a separate scheduler group to handle parsing Kafka protocol requests.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== use_produce_scheduler_group

Use a separate scheduler group to process Kafka produce requests.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `boolean`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`true`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


// tag::deprecated[]
=== use_scheduling_groups

No description available.


[cols="1s,2a"]
|===
| Property | Value

| Type
| `deprecated_property`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`null`
endif::[]

| Nullable
| No

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

|===

// end::deprecated[]

=== virtual_cluster_min_producer_ids

Minimum number of active producers per virtual cluster.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Maximum
| `18446744073709552000`

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`Maximum value`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== wait_for_leader_timeout_ms

Timeout to wait for leadership in metadata cache.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Range
| [`-17592186044416`, `17592186044415`]

| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`5000` (5 seconds)
endif::[]

| Nullable
| No

| Unit
| Milliseconds

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===


=== write_caching_default

The default write caching mode to apply to user topics. Write caching acknowledges a message as soon as it is received and acknowledged on a majority of brokers, without waiting for it to be written to disk. With `acks=all`, this provides lower latency while still ensuring that a majority of brokers acknowledge the write. 

Fsyncs follow <<raft_replica_max_pending_flush_bytes,`raft_replica_max_pending_flush_bytes`>> and <<raft_replica_max_flush_delay_ms,`raft_replica_max_flush_delay_ms`>>, whichever is reached first.

The `write_caching_default` cluster property can be overridden with the xref:reference:properties/topic-properties.adoc#writecaching[`write.caching`] topic property.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `string` (enum)

| Accepted values
|
ifndef::env-cloud[]
`true`, `false`, `disabled`
endif::[]
ifdef::env-cloud[]
`true`, `false`, `disabled`
endif::[]


| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`false`
endif::[]

| Nullable
| No

| Requires restart
| No

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| User
endif::[]

| Example
|
`true`

| Related topics
|
* xref:reference:properties/topic-properties.adoc#writecaching[`write.caching`]

* xref:develop:config-topics.adoc#configure-write-caching[Write caching]

|===


=== zstd_decompress_workspace_bytes

Size of the zstd decompression workspace.

[cols="1s,2a"]
|===
| Property | Value

| Type
| `integer`



| Default
|
ifdef::env-cloud[]
Available in the Redpanda Cloud Console
endif::[]
ifndef::env-cloud[]
`8388608`
endif::[]

| Nullable
| No

| Unit
| Bytes

| Requires restart
| Yes

ifndef::env-cloud[]
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
| Yes
endif::[]

ifndef::env-cloud[]
| Visibility
| Tunable
endif::[]

|===