// troubleshooting guide · zed
Zed Blank or Invisible Window on Linux
- Status
- Workaround available
- platforms:
- Linux, WSL
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · zed/blank-window-linux-wayland4 FIXES
// quick answer
A blank Zed window on Linux is often a Wayland or WSL issue. Forcing X11 usually works.
Most likely fix: Force X11
How to fix it
// try these in order, the most common fix is first
FIX 1Force X11
- 01Run WAYLAND_DISPLAY='' zed --foreground
- 02Or unset WAYLAND_DISPLAY; zed
Did this fix it?FIX 2Check Vulkan
- 01Run vkcube to confirm GPU works
Did this fix it?FIX 3Read the log
- 01Open ~/.local/share/zed/logs/Zed.log
Did this fix it?FIX 4Update Zed and drivers
- 01Update to the latest release, then retry
Did this fix it?
Symptoms
Zed opens an empty, invisible or frozen window.
Why it happens
- C-01Wayland compositor issue
- C-02WSL2 display setup
- C-03GPU driver problem
// this guide also covers
- zed blank window linux
- zed invisible window
- zed wayland not working
Still not working?
If Zed keeps failing, you're not alone. See every Zed 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 usThe same problem in other apps
All crashes, freezes & blank screens guides →
Sublime Text Crashing or Misbehaving: Use Safe Mode (Sublime Text)
GitHub Copilot Chat Not Responding (GitHub Copilot)
Other Zed errors
- Zed Vulkan Error on Linux (NoSupportedDeviceFound)
- Zed Slow on Linux Laptop (Using Wrong GPU)
- Zed Too Many Open Files Error on Linux
- Zed High CPU Usage or Freezing
- Zed Wrong Scaling on High-DPI Linux (X11)
- Zed Language Server Not Working
- Zed Won't Start or Crashes on Launch
- Zed Agent 'Max Tokens Reached' Error