ChanDesk - Display Issue Fix Guide
The Real Problem
You're running on a server without a graphical display. The error message means:
- ❌ No Wayland compositor running
- ❌ No X11 display server running
- ❌ No way to show GUI windows
This is like asking a TV to show a picture when it's not plugged into electricity.
Solutions (Pick One)
✅ Solution 1: Install Xvfb (Virtual Display)
# Install virtual display server
sudo apt-get update
sudo apt-get install -y xvfb
# Run your app with virtual display
xvfb-run -a npm run tauri:dev
This creates a "fake" display so the app can run (but you still won't see it).
✅ Solution 2: Test Frontend Only (RIGHT NOW)
Open your browser to test the UI without Tauri:
npm run dev
Then visit: http://localhost:1420 in your browser
✅ Solution 3: Use X11 Forwarding (If SSH)
# On your LOCAL machine, connect with X11 forwarding:
ssh -X user@your-server
# Then run:
npm run tauri:dev
The window will appear on your local machine!
✅ Solution 4: Deploy to GUI Machine (Best Option)
Copy this project to any computer with a monitor:
# On Windows/Mac/Linux Desktop:
git clone your-repo
cd 4chan
npm install
npm run tauri:dev
The window will appear instantly!
Quick Test Script
I created run-headless.sh for you:
./run-headless.sh
This builds everything to verify it works (without trying to show GUI).
Understanding the Error
Gdk-Message: Error 71 (Protocol error) dispatching to Wayland display.
Translation:
- Gdk: GTK Display Kit (UI library Tauri uses)
- Error 71: "I can't find a display server"
- Protocol error: "There's no Wayland/X11 running"
Your code is perfect. The environment just can't show GUI apps.
My Recommendation
Use Solution 2 (frontend in browser) for quick testing:
npm run dev
# Open http://localhost:1420 in browser
Or install Xvfb (Solution 1) if you want the full Tauri app to run.
Bottom line: You cannot "fix" code that isn't broken. You need to fix your environment by adding a display server.