// troubleshooting guide · espanso
Espanso Stops Working After Sleep
- Status
- Ongoing
- platforms:
- Linux (mostly)
- updated:
- November 15, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · espanso/stops-after-sleep3 FIXES
// quick answer
If expansion dies after resume, restart the service. Keep auto_restart on and restart after plugging in a keyboard.
Most likely fix: Restart
How to fix it
// try these in order, the most common fix is first
FIX 1Restart
- 01Run `espanso restart`
Did this fix it?FIX 2After new hardware
- 01Run `espanso restart` after connecting a keyboard
Did this fix it?FIX 3Report
- 01Include `espanso log` in a GitHub issue
Did this fix it?
Symptoms
Espanso shows running but no expansion after sleep or a new keyboard.
Why it happens
- C-01Input device handles lost on resume
- C-02New keyboard not detected
// this guide also covers
- espanso stops working after sleep
- espanso needs restart
Still not working?
If Espanso keeps failing, you're not alone. See every Espanso problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us