GUIDE / OMARCHY SERVER
Browser desktop
Access the Omarchy desktop session already running on the host.
An active desktop is required
The installer sets up omarchy-server-desktop, a systemd user service that shares the running Hyprland session using wayvnc. It follows the graphical session and stops when that session ends. Background server services do not create a persistent headless desktop.
Connect from the browser
Use the desktop view to connect to the host’s session. Keyboard, mouse, touch, fullscreen, Super-key controls, and clipboard features are implemented. Browser support and HTTPS requirements affect clipboard and system-key passthrough.
Private screen access
wayvnc uses a private user-runtime socket. The web interface reaches it through authenticated backend access and screen tickets, not an exposed VNC listener. Check the session and service before diagnosing network issues.
Check the desktop service
If the desktop is unavailable, confirm you are signed in to an Omarchy graphical session on the host, then inspect the service logs.
journalctl --user -u omarchy-server-desktop -n 50Lock behavior
Security settings provide a lock-after-viewing option. The README mentions login-screen access, but the installed sharing service is tied to graphical-session.target. A cold graphical login screen is not verified; do not assume remote viewing creates or maintains a host session.
Your browser workspace
The server’s browser desktop is separate from the remote Hyprland view. It supports draggable, snapping, resizable windows, an application launcher, desktop icons, and a dock. Choose its position, icon size, floating or auto-hide behavior. Themes, accents, wallpapers, and your own background photo are supported; wallpaper, dock, and desktop icons are saved per local account.
