ACL-LOAD(3valkey)

💖 NAME 💖

so this is ACL-LOAD(3valkey) from the Valkey Command Manual — the page for acl-load, and bestie, it reloads the rules from the configured ACL file. that's it, that's the whole vibe. ✨

---

🦋 SYNOPSIS 🦋

ACL LOAD

---

🌸 DESCRIPTION 🌸

okay so when Valkey is configured to use an ACL file (that's the aclfile configuration option, iykyk), this command reloads the ACLs from the file, replacing all the current ACL rules with the ones defined in the file. full swap. out with the old, in with the new. 💅

and the way it does it is all or nothing, which is honestly the healthiest boundary ever:

• if every line in the file is valid, all the ACLs are loaded. slay. ✅
• if one or more line in the file is not valid, nothing is loaded, and the old ACL rules defined in the server memory continue to be used. no half-committed mess, no chaos. 🙈

---

💌 REPLY 💌

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

but listen, it may fail with an error for several reasons: if the file is not readable, or if there is an error inside the file — and in those cases, the error will be reported to the user in the error. so you get receipts, fr fr. 👀

finally, the command will fail if the server is not configured to use an external ACL file. like, there's literally nothing to reload from, bestie. 💀

---

⚡ COMPLEXITY ⚡

O(N). where N is the number of configured users. not bad, not bad at all. ✨

---

👑 ACL CATEGORIES 👑

@admin @dangerous @slow

---

🕰️ HISTORY 🕰️

• available since: 6.0.0 🌈

---

🍓 EXAMPLES 🍓

127.0.0.1:6379> ACL LOAD
OK

127.0.0.1:6379> ACL LOAD
(error) ERR /tmp/foo:1: Unknown command or category name in ACL...

---

🔥 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-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)

---

go read all of those too, bestie, they're literally all right there 🫶

and that's the whole page!! this one came from the Valkey Command Manual, version 9.0.0, dated 2025-10-21 — so yeah, you're all caught up, no cap 💜🧚🌸