BGSAVE(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

BGSAVE 💾✨

okay bestie, welcome to the bgsave page of the Valkey Command Manual (section 3valkey, if you're keeping track 💅). She's the one who saves your whole database to disk while you keep vibing — no blocking, no drama, just a fork and a dream. 🦋

✨ NAME ✨

bgsave — asynchronously saves the database(s) to disk. no cap. 🫶

🌸 SYNOPSIS 🌸

BGSAVE [SCHEDULE | CANCEL]

💖 DESCRIPTION 💖

Save the DB in background. that's it, that's the whole vibe.

Normally the OK code is immediately returned. Valkey forks, the parent continues to serve the clients, the child saves the DB on disk then exits. it's giving "divide and conquer" and honestly? iconic. 👑

An error is returned if there is already a background save running or if there is another non-background-save process running, specifically an in-progress AOF rewrite. so yeah, if something's already cooking in the background, she's not gonna double-book herself. 😭

If BGSAVE SCHEDULE is used, the command will immediately return OK when an AOF rewrite is in progress and schedule the background save to run at the next opportunity. lowkey the politest option ever. 🎀

If BGSAVE CANCEL is used, it will immediately terminate any in-progress RDB save or replication full sync process. In case a background save is scheduled to run (e.g. using BGSAVE SCHEDULE command) the scheduled execution will be cancelled as well. she said "actually, never mind" and she MEANT it. 💀

A client may be able to check if the operation succeeded using the valkey-lastsave(7) LASTSAVE command.

Please refer to the persistence documentation for detailed information.

💌 REPLY 💌

One of the following:

🧚 COMPLEXITY 🧚

O(1)

constant time bestie, she's not out here doing loops for fun. ⭐

👑 ACL CATEGORIES 👑

@admin @dangerous @slow

ngl, the @dangerous tag is there for a reason — this one touches your persistence layer, so gate it behind proper ACLs, okay? 🙈

🌈 HISTORY 🌈

  • Available since: 1.0.0
  • Changed in 3.2.2: Added the SCHEDULE option.
  • Changed in 8.1.0: Added the CANCEL option.

she's been here since day one and still getting glow-ups. main character energy fr fr. 🔥

🦋 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), command(3valkey), command-count(3valkey), command-docs(3valkey), command-getkeys(3valkey), command-getkeysandflags(3valkey), command-help(3valkey), command-info(3valkey), command-list(3valkey), commandlog(3valkey), commandlog-get(3valkey), commandlog-help(3valkey), commandlog-len(3valkey), commandlog-reset(3valkey), config(3valkey), config-get(3valkey), config-help(3valkey), config-resetstat(3valkey), config-rewrite(3valkey), config-set(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)

and that's the page, bestie!! 🍓 this little cutie is from Valkey 9.0.0, dated 2025-10-21, filed under BGSAVE(3valkey). go save something asynchronously and hydrate. mwah. 💜✨

📦 where this page comes from