config-set.3valkey - Man Page
Sets configuration parameters in-flight.
Synopsis
CONFIG SET
parameter value [parameter value ...]
Description
The CONFIG SET
command is used in order to reconfigure the server at run time without the need to restart Valkey. You can change both trivial parameters or switch from one to another persistence option using this command.
The list of configuration parameters supported by CONFIG SET
can be obtained issuing a CONFIG GET *
command, that is the symmetrical command used to obtain information about the configuration of a running Valkey instance.
All the configuration parameters set using CONFIG SET
are immediately loaded by Valkey and will take effect starting with the next command executed.
All the supported parameters have the same meaning of the equivalent configuration parameter used in the valkey.conf\c file.
Note that you should look at the valkey.conf file relevant to the version you’re working with as configuration options might change between versions. The link above is to the latest development version.
It is possible to switch persistence from RDB snapshotting to append-only file (and the other way around) using the CONFIG SET
command. For more information about how to do that please check the persistence page.
In general what you should know is that setting the appendonly
parameter to yes
will start a background process to save the initial append-only file (obtained from the in memory data set), and will append all the subsequent commands on the append-only file, thus obtaining exactly the same effect of a Valkey server that started with AOF turned on since the start.
You can have both the AOF enabled with RDB snapshotting if you want, the two options are not mutually exclusive.
Reply
valkey-protocol(7) Simple string reply: OK
when the configuration was set properly. Otherwise an error is returned.
Complexity
O(N) when N is the number of configuration parameters provided
Acl Categories
@admin @dangerous @slow
History
- Available since: 2.0.0
- Changed in 7.0.0: Added the ability to set multiple parameters in one call.
See Also
acl(3valkey), acl-cat(3valkey), acl-deluser(3valkey), acl-dryrun(3valkey), acl-genpass(3valkey), acl-getuser(3valkey), acl-help(3valkey), acl-list(3valkey), acl-load(3valkey), acl-log(3valkey), acl-save(3valkey), acl-setuser(3valkey), acl-users(3valkey), acl-whoami(3valkey), bgrewriteaof(3valkey), bgsave(3valkey), command(3valkey), command-count(3valkey), command-docs(3valkey), command-getkeys(3valkey), command-getkeysandflags(3valkey), command-help(3valkey), command-info(3valkey), command-list(3valkey), config(3valkey), config-get(3valkey), config-help(3valkey), config-resetstat(3valkey), config-rewrite(3valkey), dbsize(3valkey), debug(3valkey), failover(3valkey), flushall(3valkey), flushdb(3valkey), info(3valkey), lastsave(3valkey), latency(3valkey), latency-doctor(3valkey), latency-graph(3valkey), latency-help(3valkey), latency-histogram(3valkey), latency-history(3valkey), latency-latest(3valkey), latency-reset(3valkey), lolwut(3valkey), memory(3valkey), memory-doctor(3valkey), memory-help(3valkey), memory-malloc-stats(3valkey), memory-purge(3valkey), memory-stats(3valkey), memory-usage(3valkey), module(3valkey), module-help(3valkey), module-list(3valkey), module-load(3valkey), module-loadex(3valkey), module-unload(3valkey), monitor(3valkey), psync(3valkey), replconf(3valkey), replicaof(3valkey), restore-asking(3valkey), role(3valkey), save(3valkey), shutdown(3valkey), slowlog(3valkey), slowlog-get(3valkey), slowlog-help(3valkey), slowlog-len(3valkey), slowlog-reset(3valkey), swapdb(3valkey), sync(3valkey), time(3valkey)