Livekit team, is there official documentation on on_shutdown anywhere? Kind of confusing, as it’s an async function, but it seems like I can’t trust it to execute all my code. I have 3 async functions within on_shutdown, one makes a db call, another makes an llm chat completion call (standalone), and then one more fast db insert call. should all execute in <5s How should I think about on_shutdown vs on_exit? Seems like the only way I can trust it is by moving all code to an api endpoint and then doing a fire-and-forget in on_shutdown. What about dirty stops, as in, client’s computer powers off mid-session?

yeah I read that doc a few times, but didn’t realize there’s a ServerOptions config. Very helpful. It looks like when running the agent locally I get Cannot write to closing transport error, but I’m deploying with lk agents create now and I expect it to work. This is very helpful, thank you!

On_shutdown node

Agents

darryncampbell (Darryn) March 1, 2026, 11:37pm 2

Did you see this? Job lifecycle | LiveKit Documentation

You can adjust this value in the ServerOptions (code here: agents/livekit-agents/livekit/agents/worker.py at main · livekit/agents · GitHub)

e.g. server = AgentServer(shutdown_process_timeout=10)

Topic		Replies	Views
Can the client check if the agent finished shutting down? Client SDKs agent-development , python	2	70	February 23, 2026
Agent Disconnects After session.shutdown(drain=True) but User Remains Stuck in Room — Production Issue Agents agent-development	7	217	March 25, 2026
Urgent: on_session_end callback not triggering in Agents SDK Agents agent-development	4	117	March 22, 2026
"process is unresponsive, killing process" - happens intermittently on long Gemini 3.1 Flash Live calls, on_session_end shutdown callback often doesn't run Getting Started	5	76	June 15, 2026
Ending a livekit agent problem Agents agent-development	5	86	July 30, 2026

On_shutdown node

Related topics