Answers
Raspberry Pi screen sharing fails on a headless Pi with Wayland
wayvnc shares a running Wayland session. On a Pi with no desktop session or no monitor, there is nothing to share until you start one.
Asked on Raspberry Pi Forums, February 2026: “Remote shell but no screen sharing”
Short answer
Screen sharing on Raspberry Pi OS goes through wayvnc, which attaches to the desktop session. If the Pi boots to the console, or no session started because no monitor is attached, wayvnc finds no Wayland socket. Boot to the desktop with auto-login, and give it a display to draw on.
1. Make sure a desktop session runs
In sudo raspi-config, under System Options → Boot / Auto Login, choose desktop with auto-login. After a reboot, ls /run/user/1000/wayland-* should show the socket.
2. Give it a display without a monitor
A session with no monitor may have no output to draw. Plug in an HDMI dummy plug, or set a headless resolution in raspi-config's display options if your release has one. Then try the screen share again.
For kiosks and signs
A kiosk already runs a session, so this mostly bites on test Pis. Fieldhand's Screen takes a screenshot on Wayland, X11 or the framebuffer, and live view starts wayvnc on demand on the running session, loopback only, carried over the Pi's outbound connection. It needs the same running session; it doesn't create one.
By Abner Souza, who builds Fieldhand. Updated 2026-10-23. Something wrong or out of date? Write to support@fieldhand.dev.
Something wrong or missing on this page? Tell us.