MODULE-LOAD(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 MODULE-LOAD — the 3valkey girlies' guide 💖

okay so bestie, we're in the Valkey Command Manual, section 3valkey, and today's main character is module-load. she's giving plugin-deploy energy and honestly? iconic.

✨ NAME ✨

module-load — loads a module. that's it, that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

MODULE LOAD path arg [arg...]

look at her. clean. simple. slaying. 💅

🦋 DESCRIPTION 🦋

So what she actually does: she loads a module from a dynamic library, at runtime, while the server is already out here living its life. no restart, no drama. 🫶

More specifically — she loads and initializes the Valkey module sitting in the dynamic library that you point at with the path argument. And listen, the path? it needs to be the absolute path of the library, including the full filename. not a vibe-y relative path, not "you know the one". the whole thing. ✨

Any extra arguments you tack on after that get passed unmodified straight through to the module. no editing, no filter, no notes. she's just the messenger. 💌

Note, bestie: modules can also be loaded at server startup using the loadmodule configuration directive in valkey.conf. so you've got options. two whole options. we love range. 🌈

💬 REPLY 💬

valkey-protocol(7) Simple string reply: OK if the module was loaded. 🎉

like, she says OK and you say thank you queen. 💖

⚡ COMPLEXITY ⚡

O(1)

constant time, no cap. fast fast fast. 🔥

🔐 ACL CATEGORIES 🔐

  • @admin
  • @dangerous
  • @slow

(yeah she's in @dangerous — respect the warning label bestie, this is real power 💀)

📜 HISTORY 📜

  • Available since: 4.0.0 ⭐

👑 SEE ALSO 👑

the whole group chat, fr fr:

acl(3valkey), acl-cat(3valkey), acl-deluser(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-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 tea, bestie 🍓

this page was brought to you by Valkey version 9.0.0, dated 2025-10-21 — go forth and MODULE LOAD responsibly, ily, mwah 💜🧚✨

📦 where this page comes from