CLUSTER-BUMPEPOCH(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 CLUSTER-BUMPEPOCH 💖

okay bestie, welcome to the Valkey Command Manual entry for cluster-bumpepoch — yes it's a real command, yes the name is giving "let's start drama in the cluster" and honestly? it kinda is. sit down, grab a strawberry 🍓, let's get into it.

✨ NAME ✨

cluster-bumpepoch — advances the cluster config epoch. that's it. that's the whole job. she bumps. she epochs. she slays. 👑

🌸 SYNOPSIS 🌸

CLUSTER BUMPEPOCH

that's literally it. no args. no flags. a clean, minimal icon. 💅

🦋 DESCRIPTION 🦋

Advances the cluster config epoch. periodt.

So the way this works: the CLUSTER BUMPEPOCH command triggers an increment to the cluster's config epoch from the connected node. and when does that actually happen, you ask? the epoch gets incremented if the node's config epoch is zero, or if it's less than the cluster's greatest epoch. those are the two doors and only one of them needs to be open, iykyk. 🚪✨

⚠️ okay bestie, real talk for a sec. config epoch management is performed internally by the cluster, and it relies on obtaining a consensus of nodes. CLUSTER BUMPEPOCH attempts to increment the config epoch WITHOUT getting the consensus — which means using it may violate the "last failover wins" rule. so like... use it with caution. this is not a "just try it and see" situation, this is a "know what you're doing" situation. no cap. 😭

💌 REPLY 💌

you get one of these two things back, and both come as a valkey-protocol(7) Bulk string reply:

  • BUMPED — the epoch was incremented. we did it bestie, we bumped. 🎉
  • STILL — the node already has the greatest configured epoch in the cluster. so like... nothing to do here, she's already the queen. 👑

⚡ COMPLEXITY ⚡

O(1) — constant time, baby. instant. zero waiting. fast like a group chat notification. 🔥

🔐 ACL CATEGORIES 🔐

  • @admin
  • @dangerous
  • @slow

three categories, and two of them are literally warning labels. that's the energy. 💀

🎀 HISTORY 🎀

  • Available since: 3.0.0

a classic. an elder. she's been here since before it was cool. 🫶

🧚 SEE ALSO 🧚

go read these too, they're all besties with this one:

and that's the whole page, bestie!! this one's from version 9.0.0, dated 2025-10-21, and it lives in the CLUSTER-BUMPEPOCH(3valkey) section of the Valkey Command Manual. go forth and bump responsibly. mwah. 💖✨🌈

📦 where this page comes from