Skip to content

sway-desktop-vnc

Version 2026.162.1430
Repo superproject

A headless sway Wayland desktop with Chrome, served over VNC on :5900 Composes sway-desktop (the sway compositor + Chrome browser + waybar + the wl/desktop tooling) with wayvnc into ONE running browser-VNC desktop, and forces WLR_RENDERER=pixman so the whole stack renders in software — no GPU required. The composition is observable: all three desktop binaries (sway, wayvnc, google-chrome-stable) land in the image, and at deploy time sway + wayvnc run together under supervisord with the VNC server reachable on display :5900.

This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.

Intent Step
check the sway Wayland compositor binary is installed
check the wayvnc VNC server binary is installed
check the Chrome browser binary is installed
check the Wayland renderer is pinned to the pixman software backend so the desktop runs without a GPU
check the sway compositor and wayvnc server both report RUNNING under supervisord
check the VNC server accepts a TCP connection on the published display port
agent-check the VNC framebuffer shows the live Chrome desktop rendered, not a blank or single-color screen
check command=test -x /usr/bin/sway && test -x /usr/bin/wayvnc && test -x /usr/bin/google-chrome-stable
check cdp=status
check vnc=status
check wl=toplevel
check dbus=list
check vnc=screenshot