Skip to main content
Version: 22.2

rpk topic alter-config

Set, delete, add, and remove key/value configs for a topic.

This command allows you to incrementally alter the configuration for multiple topics at a time.

Incremental altering supports four operations:

  1. Setting a key=value pair
  2. Deleting a key's value
  3. Appending a new value to a list-of-values key
  4. Subtracting (removing) an existing value from a list-of-values key

The --dry option will validate whether the requested configuration change is valid, but does not apply it.


rpk topic alter-config [TOPICS...] --set key=value --delete key2,key3 [flags]


Value Type Description
--appendstringArray key=value; Value to append to a list-of-values key (repeatable).
-d, --deletestringArray Key to delete (repeatable).
--dry- Dry run: validate the alter request, but do not apply.
-h, --help- Help for alter-config.
-s, --setstringArray key=value; Pair to set (repeatable).
--subtractstringArray key=value; Value to remove from list-of-values key (repeatable).
--brokersstringsComma-separated list of broker <ip>:<port> pairs (for example,--brokers ',,'). Alternatively, you may set the REDPANDA_BROKERSenvironment variable with the comma-separated list of broker addresses.
--configstringRedpanda config file, if not set the file will be searched for in the default locations.
--passwordstring SASL password to be used for authentication.
--sasl-mechanismstringThe authentication mechanism to use. Supported values:SCRAM-SHA-256, SCRAM-SHA-512.
--tls-certstringThe certificate to be used for TLS authentication with the broker.
--tls-enabled-Enable TLS for the Kafka API (not necessary if specifying custom certs).
--tls-keystringThe certificate key to be used for TLS authentication with the broker.
--tls-truststorestring The truststore to be used for TLS communication with the broker.
--userstring SASL user to be used for authentication.
-v, --verbose-Enable verbose logging (default false).