# rpk cluster config set

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

---
title: rpk cluster config set
latest-redpanda-tag: v26.2.1
latest-console-tag: v3.9.0
latest-operator-version: v26.2.1
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: July 28, 2027
latest-connect-version: 4.104.0
docname: rpk/rpk-cluster/rpk-cluster-config-set
page-component-name: streaming
page-version: "26.2"
page-component-version: "26.2"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-cluster/rpk-cluster-config-set.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-set.adoc
description: Set a single cluster configuration property. This command is provided for use in scripts.
page-git-created-date: "2023-05-17"
page-git-modified-date: "2026-08-01"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/current/reference/rpk/rpk-cluster/rpk-cluster-config-set.md -->

Set a single cluster configuration property.

This command is provided for use in scripts. For interactive editing, or bulk changes, use the `edit` and `import` commands respectively.

You may also use <key>=<value> notation for setting configuration properties:

```bash
rpk cluster config set log_retention_ms=-1
```

If an empty string is given as the value, the property is reset to its default. Use the flag `--no-confirm` to avoid the confirmation prompt.

If you set the cluster property value to an empty string, the property is reset to its default.

This command is provided for use in scripts. For interactive editing, or bulk changes, use the `edit` and `import` commands respectively.

## [](#usage)Usage

```bash
rpk cluster config set <key> <value> [flags]
```

## [](#examples)Examples

This section provides examples of how to use `rpk cluster config set`.

### [](#set-a-single-property)Set a single property

Enable auditing

```bash
rpk cluster config set audit_enabled true
```

### [](#set-multiple-properties)Set multiple properties

Enable Iceberg with REST catalog type (use `key=value` notation)

```bash
rpk cluster config set iceberg_enabled=true iceberg_catalog_type=rest
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --no-confirm | bool | Disable confirmation prompt. |
| --timeout | duration | Maximum time to poll for operation completion before displaying operation ID for manual status checking (for example, 300ms, 1.5s, 30s). |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |

> 📝 **NOTE**
>
> Setting properties to non-number values (such as setting string values with `-`) can be problematic for some terminals due to how POSIX flags are parsed. For example, the following command may not work from some terminals:
>
> ```bash
> rpk cluster config set delete_retention_ms -1
> ```
>
> Workaround: Use `--` to disable parsing for all subsequent characters. For example:
>
> ```bash
> rpk cluster config set -- delete_retention_ms -1
> ```

## [](#suggested-reading)Suggested reading

-   [Cluster Properties](https://docs.redpanda.com/streaming/current/reference/properties/cluster-properties/)