// troubleshooting guide · pulsar
Pulsar Blank Screen or Crash on Linux
- Status
- Workaround available
- platforms:
- Linux
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · pulsar/blank-screen-linux3 FIXES
// quick answer
On Linux a blank window or crash is usually a GPU or Wayland problem. Update to 1.133.1 and try X11 or the ozone-platform flag.
Most likely fix: Update to 1.133.1 or newer
How to fix it
// try these in order, the most common fix is first
FIX 1Update to 1.133.1 or newer
- 01Install the latest release; 1.133.1 fixes a Linux renderer crash when opening a file
Did this fix it?FIX 2Try X11 or flags
- 01Launch with pulsar --ozone-platform=x11
- 02Or try --disable-gpu
- 03Native Wayland without flags is planned for 1.134
Did this fix it?FIX 3Start in safe mode
- 01Run pulsar --safe to rule out packages
- 02Back up ~/.pulsar, then test with a fresh config
Did this fix it?
Symptoms
Pulsar opens a blank window, closes immediately or crashes when opening a file.
Why it happens
- C-01Wayland or GPU driver problem with Electron
- C-02Linux-only renderer crash on file open fixed in 1.133.1
- C-03Corrupt package or config
// this guide also covers
- pulsar blank screen linux
- pulsar not opening linux
- pulsar wayland
Still not working?
If Pulsar keeps failing, you're not alone. See every Pulsar 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