Knowledge Base
Searching in : Article
ID: AR02P00969
Applies to: NoMachine Software
Added on: 2018-02-28
Last Update: 2024-07-31

Notes for connections to Linux physical desktops running Wayland

NoMachine (since v6.1) is able to connect to Linux physical desktops on Wayland.

The Wayland display server protocol (https://wayland.freedesktop.org/), is supported by desktop environments such as GNOME 3.20+ or later, KDE Plasma 5.4 or later, Enlightment and Hawaii. Support for Wayland may also be added in any of the next releases of lightweight desktops such as Xfce and Mate.

On some Linux distributions such as Fedora 27 or later and Ubuntu 17.10, Wayland is enabled by default but it's still possible to switch back to X.org. In other cases, such as with new installations of Ubuntu 18.04, X.org is the default display server but Wayland is provided as an option.

In the case of connections by NoMachine, it's preferable to choose to run GDM/GNOME desktops on Wayland than other display managers.

There are some known limitations when running desktop environments on Wayland, which will be present also in NoMachine sessions.

Since v8, the support for the EGL screen capture interface is enabled by default in NoMachine. This is convenient when connecting to a Linux physical display running under Wayland.

Egl screen capture can be disabled/re-enabled with command:

$ sudo /etc/NX/nxserver --eglcapture no
$ sudo /etc/NX/nxserver --eglcapture yes

For NoMachine v.7 command is:
$ sudo /etc/NX/nxserver --egl-capture no
$ sudo /etc/NX/nxserver --egl-capture yes

For NoMachine versions older than v. 6.10.12 and not supporting EGL, it is suggested to use Open Source drivers; possible workarounds are available over the Internet, it's advisable to consult the online resources  for your Linux system and GPU card.

For more about connecting to a Wayland-based desktop running in a Linux virtual machine see also:
https://kb.nomachine.com/AR04R01083

 

KNOWN LIMITATIONS

1) The following features are supported since NoMachine v. 7.7.4, but require D-Bus and PipeWire being present and properly working on the system:
- Sharing of multiple monitors connected to the remote computer 
- Blanking of the remote physical screen when somebody is connected by NoMachine
- Tracking of remote cursor position
- Automatic resize of the remote desktop to fit the client or the browser window (in case of NoMachine web sessions)

2) The following features are not supported:
- Automatic screen lock upon disconnection is not supported.
- Headless systems
   NoMachine captures the output of the desktop compositor (e.g. GNOME Shell/Mutter or KDE Plasma/Kwin).
   If the monitor is not attached, no real video output exists and NoMachine cannot render the remote desktop.
- File transfer by drag and drop is not supported.
   It's however possible to upload/download files via the NoMachine facilities, see:
   https://www.nomachine.com/sharing-files-between-computers) or by connecting remote/locale disks in the
   NoMachine session and access their content.

3) At the moment Wayland doesn't provide an API to disable the keyboard autorepeat function on server side and NoMachine cannot do it automatically. This means that especially when there is a network slowness and the delay between key press and key release events increases, it's possible that unwanted repeated key presses occur. As a workaround, disable key autorepeat manually in the system settings of the server host.

4) Other known problems are:
- The cursor shape is sometimes not captured correctly.
- Clipboard may work in a non reliable way, leading to paste operations failing from time to time.
  Re-trying to copy and paste content can help.