ACL-DELUSER(3valkey)

💅 ACL-DELUSER — the valkey manual page, but make it make sense

okay bestie, welcome to acl-deluser(3valkey), part of the Valkey Command Manual. this is the one that says goodbye to users. permanently. 💀

---

✨ NAME ✨

acl-deluser — Deletes ACL users, and terminates their connections.

---

🎀 SYNOPSIS 🎀

ACL DELUSER username [username...]

---

🦋 DESCRIPTION 🦋

So here's the tea: ACL DELUSER deletes all the specified ACL users and terminates all the connections that are authenticated with such users. not just "logs them out" — like, the whole connection? gone. bye. 👋

⚠️ note note note: the special default user cannot be removed from the system. that's the default user that every new connection is authenticated with, so like, she's not going anywhere, she's the main character. 👑

And if your list of usernames includes some that don't even exist? no stress, no drama. in such case no operation is performed for the non existing users. she simply doesn't know her. 🙈

---

💖 REPLY 💖

valkey-protocol(7) Integer reply: the number of users that were deleted.

and bestie, lowkey important: this number will not always match the number of arguments, since certain users may not exist. do the math accordingly. ✨

---

🔥 COMPLEXITY 🔥

O(1) amortized time considering the typical user.

translation: fast fast. no cap. 💅

---

🌈 ACL CATEGORIES 🌈

@admin @dangerous @slow

(yes she's all three. iconic behavior honestly.)

---

🌸 HISTORY 🌸

• Available since: 6.0.0

---

⭐ EXAMPLES ⭐

127.0.0.1:6379> ACL DELUSER antirez
(integer) 1

one (1) user deleted, one (1) integer returned, zero (0) survivors. slay. 💅

---

👑 SEE ALSO 👑

the whole friend group, fr fr:

• acl(3valkey)
• acl-cat(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)
• 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 whole page bestie!! this one came from the Valkey 9.0.0 manual, dated 2025-10-21, and it lives under the name ACL-DELUSER(3valkey). go forth and delete responsibly, mwah 🫶✨