Currently, the HeartbeatRM Linux agent is only able to communicate with Xorg to capture the desktop display. This means that if your desktop environment is using Wayland, then you’ll receive a blank image or a timeout when attempting to remotely access the desktop or take a screenshot. To resolve this, you can disable Wayland and switch back to using Xorg.

Steps to Disable Wayland

1. Open /etc/gdm/custom.conf and uncomment the line: WaylandEnabled=false
2. Add the following line to the [daemon] section: DefaultSession=gnome-xorg.desktop
3. Save the custom.conf file
4. Reboot the system

On Ubuntu 22.04, the custom.conf is located at /etc/gdm3/custom.conf.

Some other distributions may not have a custom.conf and instead will have a daemon.conf. You may make the same changes as above in this file with the same effect.

On Debian 11, edit the /etc/gdm3/daemon.conf instead.

Example custom.conf in Ubuntu 22.04