Launching the Agent in GNOME 49+ on Ubuntu/Debian¶

In the latest official Ubuntu and Debian distributions, the GNOME 49+ desktop environment is enabled by default. It uses the new Wayland display protocol, which replaces the older X.org (X11). Wayland support is currently under development, and it will take some time before we fully implement it. However, you can still maintain remote access to your devices by switching back to the previous X.org (X11) protocol.

Launching on Wayland¶

You’ll see this message when trying to launch the Agent application in a session running under the Wayland protocol.

It indicates that to use the application, you need to switch to the X.org (X11) protocol.

Switching to X.org¶

Open the terminal and enter the following command:

sudo nano /etc/gdm3/custom.conf

You’ll see configuration parameters for the GNOME Display Manager (GDM) service (daemon).

Uncomment or add the following line to disable the Wayland protocol:

WaylandEnable=false

Restart the service:

systemctl restart gdm3

When the service restarts, the screen will briefly go black and then relaunch using the X.org (X11) protocol.
You can verify this by running the following command:

echo $XDG_SESSION_TYPE

The output should be x11.

You can now start the Agent application and control this device remotely.