CONFIG-SET(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💅 CONFIG-SET (3valkey)

okay bestie, welcome to the valkey manual page for CONFIG SET, and honestly? this one is iconic. it's giving "I want to change things WITHOUT restarting my whole entire server." main character energy fr fr.

✨ NAME ✨

config-set — sets configuration parameters in-flight. yes, like mid-flight. like changing your outfit while the plane is already in the air. 💖

🎀 SYNOPSIS 🎀

CONFIG SET parameter value [parameter value ...]

🌸 DESCRIPTION 🌸

so the CONFIG SET command is THE girl for reconfiguring the server at run time without needing to restart Valkey. no restart, no downtime, no drama. you can change both trivial little parameters or switch from one persistence option to another using this command. lowkey powerful.

the list of configuration parameters that CONFIG SET supports? you can get it by issuing a valkey-config-get(7) CONFIG GET * command. that's the symmetrical command — the one you use to get info about the configuration of a running Valkey instance. they're besties, they mirror each other. 🪞

all the configuration parameters you set using CONFIG SET are immediately loaded by Valkey and will take effect starting with the next command executed. immediate. no waiting around, no "let me think about it." ⚡

all the supported parameters have the same meaning as the equivalent configuration parameter used in the valkey.conf file. same energy, same meaning.

heads up bestie: you should look at the valkey.conf file relevant to the version you're working with, because configuration options might change between versions. the link above points to the latest development version. don't be reading the wrong version's docs and then acting surprised, ok? 😭

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 info on 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 as a Valkey server that started with AOF turned on since the start. periodt. 👑

you can have both the AOF enabled with RDB snapshotting if you want. the two options are not mutually exclusive. have both. slay. ✨

🦋 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

not me flagging @dangerous... it said what it said. be careful out here. 💀

⭐ HISTORY ⭐

  • Available since: 2.0.0
  • Changed in 7.0.0: Added the ability to set multiple parameters in one call.

🌈 SEE ALSO 🌈

okay that's the whole page bestie, you ate that 🫶 this edition is from 9.0.0, dated 2025-10-21, and yes that's your girl Valkey — go forth and reconfigure things in-flight like the icon you are. 💖✨🎀

📦 where this page comes from