#Warp Keeps Crashing?

3 messages · Page 1 of 1 (latest)

hollow orbitBOT Oct 3, 2025, 7:12 AM

Hi @subtle silo. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

If Warp keeps crashing, there are several known causes and fixes depending on your operating system and the specific symptoms. Here are some troubleshooting steps and solutions based on recent reports:

1. Delete Warp's SQLite Database (macOS)

A common cause of crashes, especially after updates or on launch, is a corrupted session restoration database. Deleting this file often resolves the issue:

rm "$HOME/Library/Application Support/dev.warp.Warp-Stable/warp.sqlite"

This will remove session restoration data and can fix crashes on startup or after updates. More details and instructions are available in the Warp documentation and have been confirmed to resolve issues for multiple users Warp crashes on macOS 26.0 immediately after launch, Warp crashing on launch on macOS.

2. Update to the Latest Version

Many crash issues are fixed in newer releases. If you’re experiencing crashes, make sure you’re running the latest version of Warp. Sometimes, a hotfix is released shortly after a problematic update Warp crashing on launch on macOS, New update of Warp is crashing - Windows.

3. Linux: GPU Driver Issues

On Linux, especially with NVIDIA or nouveau drivers, Warp may crash or even hang your system. Workarounds include:

Updating or reverting your GPU drivers.
Setting environment variables to change the graphics backend, e.g.:
```
export WGPU_BACKEND=vulkan
```
See more workarounds in the Warp Linux known issues Warp on Linux is unusable due to constant random crashes, Previous warp hangs system, current crashes Window Manager.

4. macOS Keychain Deadlock

If Warp hangs indefinitely, it may be stuck trying to write to the macOS keychain. Restarting your computer can sometimes resolve this. Disabling features like "Codebase Context" in AI settings may also help Warp hangs indefinitely on macOS after Feb 27 update.

5. Other Workarounds

Reboot your machine after updating or after a crash.
Uninstall and reinstall Warp if the above steps do not help.
If you encounter issues after changing appearance settings, try resetting them or deleting the SQLite database as above.

If none of these steps resolve your issue, check the Warp known issues page and consider submitting logs or crash reports to the Warp team for further assistance.