Supported Distributions
Debian 10, 11, 12, and 13
Ubuntu 20.04 LTS, 22.04 LTS, and 24.04 LTS
The non-LTS versions of Ubuntu are supported on a best effort basis. Distributions based on the listed distributions are also supported on a best effort basis.
Packages for RHEL and derived distributions are not yet available. Reach out to support if you use RHEL in your environment.
Wayland
At this time it is recommended to use X11, although the sender is compatible with Wayland provided your compositor supports the Remote Desktop Portal or ScreenCast Portal. IT Agent recognizes that X11 is deprecated and distributions will soon switch to being Wayland only, but there are still technical limitations for this specific use case, particularly in the context of most of the LTS distributions which don't ship the latest compositor features.
Under Wayland the screen shot functionality is not available due to Wayland's restrictions. The Screenshot portal is not suitable for this particular use case and method for obtaining a screenshot otherwise is compositor specific.
Remote access on Wayland currently requires the user of the system to respond to a consent dialog for each session. If the compositor doesn't support the Remote Desktop portal then the user will need to select the display they want to share as part of the consent dialog.
Note that these caveats only apply to endpoint devices running the sender. The receiver fully supports Wayland.
Desktop Environment Notes
The sender supports GNOME and KDE, but should work with most of the popular desktop environments.
GNOME
Recent versions of GNOME default to Wayland for both the greeter and the desktop session. If possible prefer the X11 session and configure the greeter to also use X11. To do this open /etc/gdm3/daemon.conf and set WaylandEnable=false.
KDE
Wayland screen capture under KDE is currently known to have poor quality and dropped frames. At this time, this seems to be a limit in KWin's passing of software frame buffers through PipeWire.
SDDM does not have first class support for running remote access software, so to provide remote access to the greeter the sender wraps the Xsetup command. This is done by dropping in a sddm.conf value in /usr/lib/sddm/sddm.conf.d/90-itagent.conf. The installed Xsetup script in turn calls the default one provided by SDDM.
Although KDE supports Wayland, it's still experimental in SDDM for the supported distrost. Thus unlike GDM, there's no reconfiguration necessary. The X11 Plasma session is recommended at this time.
Others Using LightDM
Similar to KDE's SDDM, we also wrap the greeter setup for LightDM (used by Xfce, Cinnamon, MATE, Unity, and others). See the drop-in for lightdm.conf located at /usr/share/lightdm/lightdm.conf.d/90_itagent.conf if you have other software that does the same.
The wrapper script installed by the sender detects the wrapper that's already installed by Ubuntu and chains to it should it exist.
