How do I disable Wayland to use VNC Connect?


VNC Connect does not currently support Wayland on Linux, so if you are using a version of Linux that uses Wayland by default (Ubuntu 18.04 and later, CentOS / RHEL 8 and later), you will need to disable it.

If you don't disable Wayland, when you connect to VNC Server on these OSes you will see a blank/blank screen or a message stating "Cannot currently show the desktop", or find you cannot connect until there is a user logged in on the remote computer. The VNC Server GUI may also fail to load.

To disable Wayland, you need to:

  1. Locate the correct configuration file for your OS. This is one of /etc/gdm3/custom.conf (Ubuntu) or /etc/gdm/custom.conf (CentOS/RHEL)
  2. Open the file with sudo/root privileges
  3. Uncomment WaylandEnable=false by deleting the # at the beginning of the line
    1. Alternatively, run the below command
      sudo sed -i 's/^#.*WaylandEnable=.*/WaylandEnable=false/' /etc/gdm3/custom.conf #Ubuntu
      sudo sed -i 's/^#.*WaylandEnable=.*/WaylandEnable=false/' /etc/gdm/custom.conf #CentOS/RHEL
  4. Reboot the VNC Server computer
Was this article helpful?
36 out of 71 found this helpful



Please sign in to leave a comment.