SCRIPT-KILL(3valkey)

💅 SCRIPT-KILL

okay so bestie, welcome to the SCRIPT KILL page from the Valkey Command Manual (that's valkey manual, section 3, iykyk) 💖

---

✨ NAME ✨

script-kill — Terminates a server-side Lua script during execution. 🎀

---

✨ SYNOPSIS ✨

SCRIPT KILL

---

✨ DESCRIPTION ✨

So basically this one kills the valkey-eval(7) EVAL script that's currently executing — but only if the script hasn't done a write operation yet. No writes, no problem. 🫶

Where this really eats: it's mainly useful for killing a script that's been running for wayyyyy too long (for instance, because it entered an infinite loop because of a bug 🙈). The script gets killed, and the client that's currently blocked inside EVAL will see the command return with an error. Not the fun kind of notification, but a notification.

🚨 Okay now the important part, pay attention bestie. If the script has already performed write operations, it cannot be killed this way, because that would violate Lua's script atomicity contract. Periodt. In that case, the only thing that can kill the script is valkey-shutdown(7) SHUTDOWN NOSAVE — which kills the Valkey process in a hard way and prevents it from persisting with half-written information. Yes, that's as dramatic as it sounds. 💀

Wanna know more about EVAL scripts? Go read valkey-eval-intro(7) Introduction to Eval Scripts. It's giving required reading. 📚

---

✨ REPLY ✨

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

---

✨ COMPLEXITY ✨

O(1)

Literally constant time, she's efficient like that. ⭐

---

✨ ACL CATEGORIES ✨

• @scripting
• @slow

---

✨ HISTORY ✨

• Available since: 2.6.0 🕰️

---

✨ SEE ALSO ✨

• eval(3valkey)
• evalsha(3valkey)
• evalsha_ro(3valkey)
• eval_ro(3valkey)
• fcall(3valkey)
• fcall_ro(3valkey)
• function(3valkey)
• function-delete(3valkey)
• function-dump(3valkey)
• function-flush(3valkey)
• function-help(3valkey)
• function-kill(3valkey)
• function-list(3valkey)
• function-load(3valkey)
• function-restore(3valkey)
• function-stats(3valkey)
• script(3valkey)
• script-debug(3valkey)
• script-exists(3valkey)
• script-flush(3valkey)
• script-help(3valkey)
• script-load(3valkey)
• script-show(3valkey)

---

k bye ily, go forth and terminate your runaway scripts responsibly 💜✨

this page came to you from version 9.0.0, dated 2025-10-21 — slay 🎀👑