# 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: v25.1.1
latest-console-tag: v3.7.3
latest-operator-version: v26.1.4
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "true"
page-eol-date: April 7, 2026
latest-connect-version: 4.93.0
docname: rpk/rpk-cluster/rpk-cluster-config-set
page-component-name: streaming
page-version: "25.1"
page-component-version: "25.1"
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/v/25.1/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-set.adoc
page-git-created-date: "2023-05-17"
page-git-modified-date: "2025-05-09"
support-status: past end-of-life
---

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

Set a cluster configuration property. You can set a single property or multiple properties at once, for example:

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

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

You must use `<key>=<value>` notation to set multiple properties.

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.

For a list of available properties, see [Cluster Configuration Properties](https://docs.redpanda.com/streaming/25.1/reference/properties/cluster-properties/).

## [](#usage)Usage

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

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -h, --help | - | Help for set. |
| --all | - | Include all properties, including tunables. |
| --config | string | Redpanda or rpk config file; default search paths are /var/lib/redpanda/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail. |
| --profile | string | Profile to use. See rpk profile for more details. |
| -v, --verbose | - | 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:
>
> ```none
> rpk cluster config set delete_retention_ms -1
> ```
>
> Workaround: Use `--` to disable parsing for all subsequent characters. For example:
>
> ```none
> rpk cluster config set -- delete_retention_ms -1
> ```