Glossary

    What Is Unattended Remote Control on Wayland?

    Definition, mechanics, and what makes it harder than X11.

    What is unattended remote control on Wayland?

    Unattended remote control on Wayland is the ability to remotely view and operate a Linux device running the Wayland display server when no user is at the keyboard, including at the GDM or SDDM login screen, after a reboot, or on a headless endpoint with no user session yet established. It requires either the GNOME headless remote-login service, a vendor-built system-level integration, or a portal-based persistent session pattern, because Wayland's standard screen-capture and input flow assumes a user is present to grant consent.

    Last reviewed: · DeviceView editorial

    Read the guideJump to definition

    Context

    Why the term exists

    "Unattended" distinguishes the use case from "attended" remote support, where a user is sitting at the device, can see a consent prompt, and clicks Allow. Most remote-support tools were built first for the attended case. The unattended case (IT support at 3 AM, a kiosk reboot, a help-desk ticket while the user is on PTO, an off-hours patch on a clinical workstation) is operationally different in one specific way: there is no user available to consent.

    On X11, that difference did not matter much. X11 exposed screen capture and input injection broadly, and any authenticated client could attach to a session or to the display server itself. On Wayland the difference is structural. Wayland's compositor mediates capture and input. The default flow assumes a user grants per-session consent through xdg-desktop-portal. Unattended use is therefore not the default path; it requires a deliberately different mechanism.

    Coverage

    The three things "unattended" has to cover

    To call a Linux remote-support tool unattended in 2026, three scenarios all have to work, not just one of them.

    Login screen

    The endpoint sits at the GDM or SDDM login screen with no user logged in. The operator must be able to connect, authenticate, and either drive the greeter or land in a privileged session.

    Post-reboot, pre-login

    After a reboot, before any user logs in, the operator can re-establish a session. This is the test that catches tools that store unattended state inside a user session.

    Locked screen and headless

    A locked screen is the same kind of test in miniature. A headless endpoint with no monitor pushes harder: some implementations capture the compositor's display output and have nothing to capture if no display exists.

    A tool that handles only post-login is not "unattended" in the IT-operations sense. It is interactive remote support that needs a user to log in first.

    Comparison

    How it differs from attended

    AspectAttended remote supportUnattended remote control
    User presenceUser at the keyboardNo user present (by definition)
    Consent modelPer-session user dialog (xdg-desktop-portal)Authorization granted at enrollment by IT, governed by RBAC and audit
    Login-screen accessNot relevant, user is logged inRequired
    Post-rebootOften N/ARequired
    Use casesHelp-desk walkthroughs, training, screen-share-based troubleshootingAfter-hours patching, pre-login configuration, kiosk and lab support, headless equipment, automated remediation
    Failure mode if mistaken for the otherUsers feel surveilled; consent model is invisibleEndpoint is unreachable when help is needed

    Mechanics

    Why it is harder on Wayland

    Wayland's display protocol places the compositor (Mutter on GNOME, KWin on KDE) in charge of screen capture and input. Standard remote desktop on Wayland goes through the xdg-desktop-portal RemoteDesktop interface, which surfaces a consent dialog the user clicks. Unattended use cases have no user to click, so the standard flow does not apply.

    Portal persistent session
    The xdg-desktop-portal pattern where a one-time grant is stored as a restore_token and replayed on subsequent connections.
    GNOME headless remote-login
    gnome-remote-desktop integrated with GDM, available since GNOME 46, providing RDP access to the login screen and through to the desktop session.
    Vendor system-level integration
    A vendor-built integration with the desktop environment that operates outside the per-session portal flow, with policy and audit governed at the fleet level.

    Each has trade-offs. For the deeper architectural breakdown, see Why unattended remote desktop is hard on Wayland.

    Frequently asked questions

    Evaluate Wayland support with confidence

    Read the deep-dive guide, or jump straight to the verified compatibility matrix for your distro and greeter.

    Read: Why unattended remote desktop is hard on WaylandValidate Wayland support for your distro and greeter

    We use cookies to understand how you use DeviceView.