# rpk cluster config force-reset

> 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 force-reset
latest-redpanda-tag: v26.1.9
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: "false"
page-eol-date: March 31, 2027
latest-connect-version: 4.93.0
docname: rpk/rpk-cluster/rpk-cluster-config-force-reset
page-component-name: streaming
page-version: "26.1"
page-component-version: "26.1"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-cluster/rpk-cluster-config-force-reset.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-force-reset.adoc
page-git-created-date: "2023-05-17"
page-git-modified-date: "2025-11-19"
support-status: supported
---

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

Forcibly clear a cluster configuration property on a broker.

Do not use this command for general changes to cluster configuration. Use `force-reset` only when Redpanda does not start due to a configuration issue; for example, when a property is set to an invalid value or when a property is missing that Redpanda requires to start.

This command erases the named property from an internal cache of the cluster configuration on the local broker, so that on next startup Redpanda treats the property as if it was set to the default.

If your cluster is working properly and you want to reset a property to its default value, either use the `set` command with an empty string, or use the `edit` command and delete the line containing the property.

> ⚠️ **WARNING**
>
> Use this command only when Redpanda isn’t running.

## [](#usage)Usage

```bash
rpk cluster config force-reset [PROPERTY...] [flags]
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --cache-file | string | Location of configuration cache file (defaults to Redpanda data directory). |
| -h, --help | - | Help for force-reset. |
| --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. |