Run scheduled GUI automation reliably when the target machine's console is locked or has no attached display

domain: learn.microsoft.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. On Linux, run the GUI process under Xvfb (or xvfb-run) to give it a virtual, in-memory X11 display so display-dependent apps launch without a physical monitor
  2. On Linux CI, give each parallel automation run its own Xvfb display number rather than sharing one virtual display across concurrent jobs
  3. On Windows, note there is no built-in virtual display equivalent to Xvfb — GUI automation triggered while the console is locked or via a non-interactive scheduled task session typically can't render or interact with the desktop the way an interactive session can; a VM or an actively connected console/RDP session is the common workaround
  4. Prefer connecting to the physical console session (e.g. mstsc /admin) over a disconnectable RDP session, since disconnecting can suspend desktop compositing on some Windows configurations and break automation that depends on rendering
  5. For headless browser-only automation, skip virtual displays and native GUI concerns entirely by using the browser's own headless mode, which needs no display server

Known gotchas

Related routes

Configure a Power Automate Desktop flow to run unattended on a schedule without an active console session
learn.microsoft.com · 5 steps · unrated
Replace Thread.Sleep waits with FlaUI's Retry.While/WhileException helpers for reliable Windows UI automation
desktop-automation · 6 steps · unrated
Configure a scheduled automatic unlock (and exceptions) for a Kisi-controlled door instead of a one-off remote unlock
docs.kisi.io · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans