ACL-LIST(3valkey)

💅 ACL-LIST — the "show me everyone's receipts" command

okay bestie, welcome to the Valkey Command Manual entry for ACL LIST, a.k.a. the moment the server spills the tea on every single user it's currently tracking. ✨

---

🌸 NAME 🌸

acl-list — dumps the effective rules in ACL file format. that's it, that's the whole job, and it does it flawlessly. 👑

---

🎀 SYNOPSIS 🎀

ACL LIST

no args, no flags, no notes. she's low-maintenance and highkey iconic. 💅

---

🦋 DESCRIPTION 🦋

so here's the vibe: this command shows you the currently active ACL rules living inside your Valkey server. 🫶

every single line in the returned array = a different user. and the format? it's the exact same format used in the valkey.conf file or the external ACL file. which means — and this is the slay part — you can literally cut and paste whatever ACL LIST hands you straight into a config file if you want. no conversion, no drama, no nothing. 💖

⚠️ but bestie, be careful: make sure to check valkey-acl-save(7) / ACL SAVE before you go pasting things around. do not skip that step, i'm begging. 🙈

---

📬 REPLY 📬

valkey-protocol(7) Array reply: an array of valkey-protocol(7) Bulk string reply elements. so basically: a list, and inside that list, strings. simple. gorgeous. ⭐

---

🔥 COMPLEXITY 🔥

O(N). where N is the number of configured users. more users = more lines = more time. math is math. 🧮✨

---

👑 ACL CATEGORIES 👑

@admin @dangerous @slow

(the trifecta of "yes this touches real stuff, yes it might be slow, yes it needs permission." main character energy honestly. 💀)

---

🌈 HISTORY 🌈

• available since 6.0.0 — a certified classic at this point, fr fr. 🎀

---

🍓 EXAMPLES 🍓

watch her work:

127.0.0.1:6379> ACL LIST
1) "user antirez on #9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08 ~objects:* &* +@all -@admin -@dangerous"
2) "user default on nopass ~* &* +@all"

look at that formatting. every rule, right there, readable, copy-pasteable, gorgeous. the ~objects:* and &* and +@all -@admin -@dangerous of it all?? ate and left no crumbs. 💅✨

---

👯 SEE ALSO 👯

the whole friend group, because nobody does it alone:

• acl(3valkey)
• acl-cat(3valkey)
• acl-deluser(3valkey)
• acl-dryrun(3valkey)
• acl-genpass(3valkey)
• acl-getuser(3valkey)
• acl-help(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!! 🎀 go forth and ACL LIST responsibly. mwah. 💖

this was <strong>Valkey 9.0.0</strong>, dated <strong>2025-10-21</strong>, from the ACL-LIST(3valkey) manual page — tysm for reading, ily, bye!! ✨🦋💜