CLIENT-CAPA(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 CLIENT-CAPA — bestie, it's in the valkey(3valkey) manual 💖

okay so real talk, this is CLIENT-CAPA, a page straight out of the Valkey Command Manual. She's giving "let the server know what you can handle" and honestly? iconic behavior. let's get into it 🫶

✨ NAME ✨

client-capa — a client claims its capability. yes that's the whole name and yes she ate 💅

✨ SYNOPSIS ✨

CLIENT CAPA capability [capability...]

✨ DESCRIPTION ✨

so here's the vibe: clients can declare their capabilities to Valkey using the CLIENT CAPA command, and Valkey will adjust the corresponding features for the current connection based on whatever the client declared. it's literally just you telling the server "hey, I can do this" and the server going "say less" 🔥

you can declare multiple capabilities in the same command, no problem. and here's the chill part — if any capabilities are unrecognized, Valkey will just ignore them instead of returning an error. no drama, no error message, just vibes ✨

the capabilities currently supported are:

  • redirect — this one means the client is capable of handling redirect messages. so when you're accessing a replica node in standalone mode and a data operation happens (read or write commands), Valkey will return -REDIRECT primary-ip:port to this connection. and bestie, listen — the primary-ip can be an IPv6, which itself contains colons 🫠 so to properly parse the ip and port, a client needs to locate the last colon. that's the trick, that's the whole thing. also, using the valkey-readonly(7) READONLY command can enable this connection to execute read commands on the replica node. lowkey useful, highkey important 👑

✨ REPLY ✨

valkey-protocol(7) Simple string reply: OK.

that's it. that's the reply. OK and we move on 💖

✨ COMPLEXITY ✨

O(1) — constant time, no notes, she's efficient 💅

✨ ACL CATEGORIES ✨

@connection @slow

✨ HISTORY ✨

  • Available since: 8.0.0 ⭐

✨ SEE ALSO ✨

go read these too, bestie, they're all part of the family:

and that's the whole page, you're welcome 💖✨

this was Valkey 9.0.0, dated 2025-10-21 — go forth and declare your capabilities, bestie, the server is ready for you 🎀🦋💜

📦 where this page comes from