Zed Not Working? Common Errors & Fixes
The 11 Zed problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
Zed Vulkan Error on Linux (NoSupportedDeviceFound)
Workaround availableLinuxZed on Linux needs a working Vulkan GPU. Test with vkcube, then install or switch Vulkan drivers.
Zed Blank or Invisible Window on Linux
Workaround availableLinux, WSLA blank Zed window on Linux is often a Wayland or WSL issue. Forcing X11 usually works.
Zed Slow on Linux Laptop (Using Wrong GPU)
Workaround availableLinuxOn hybrid-graphics laptops Zed may use the integrated GPU. Set DRI_PRIME=1 to use the discrete one.
Zed Too Many Open Files Error on Linux
Fixed in latest versionLinuxRaise the inotify limits. Zed needs a watch per directory in open projects.
Zed High CPU Usage or Freezing
OngoingmacOS, Windows, LinuxUpdate Zed, restart language servers and check graphics. Known cases include sleep resume on X11 with NVIDIA.
Zed Wrong Scaling on High-DPI Linux (X11)
Workaround availableLinuxSet Xft.dpi or GPUI_X11_SCALE_FACTOR.
Zed Language Server Not Working
Workaround availableAllRestart the language server and check the extension and log.
Zed Won't Start or Crashes on Launch
Workaround availablemacOS, Windows, LinuxMoving the workspace database aside often fixes startup failures.
Zed Agent 'Max Tokens Reached' Error
Workaround availableAllStart a new thread, pick a larger-context model, or split the task.
Zed AI Usage Stopped (Spend Limit Reached)
Workaround availableAllRaise the monthly spend limit, fix failed invoices, or use your own API keys.
How to Cancel Zed Pro Subscription
Workaround availableWebManage or cancel Pro at dashboard.zed.dev, or email billing-support@zed.dev.
Problem not listed? See all Zed complaints or compare Zed alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like Zed: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code