VNC and Wayland
RealVNC are pleased to make available a free Developer Preview* of our flagship VNC product that enables VNC Server to run in a Wayland environment, and remote desktops provided by the Weston reference compositor. Feedback welcome!
* The Developer Preview is free for the Wayland development community to use, but please note it is provided “as is” and without warranty of any kind. Deployment is not recommended in a production environment.
Download the relevant VNC for Wayland Developer Preview binary (32-bit or 64-bit), and the license key, from GitHub Releases.
Note: Reference instructions for setting up an evaluation environment are available here.
Download VNC 5.2.0 (note this is an older version), and install VNC Server by running a command such as
sudo dpkg -i <VNC-Server>.debor
sudo rpm -U <VNC-Server>.rpm.
Apply the license key to VNC Server by running the command
sudo vnclicense -add <key>.vnclicense.
Copy the three Developer Preview files to a path location such as
/usr/local/bin, and make sure they are executable.
Make sure your user is a member of the
# ~/.config/weston.ini [core] modules=screen-share.so [screen-share] command=vncserver-wayland
Running VNC Server
To run VNC Server in User Mode
Launch a Weston desktop.
Note: is only useful to start VNC Server once per user session.
VNC Server in User Mode interacts with Wayland and Weston as follows:
To run VNC Server in Virtual Mode
Run the following command:
You can start VNC Server as many times as you like, to create as many virtual desktops as you need.
VNC Server in Virtual Mode interacts with Wayland and Weston as follows:
Establishing a connection from VNC Viewer
Download VNC Viewer to any supported Windows, Mac, Linux, or UNIX computer.
Connect VNC Viewer to VNC Server using these instructions.
Restrictions and notes
This section lists differences between the Wayland and a standard X-based installation of VNC 5.2.0 with an Enterprise license:
VNC Server in Service Mode (
vncserver-x11-serviced) is not available.
The VNC Server in Virtual Mode daemon (
vncserver-virtuald) is not available.
Printing, file transfer, chat, and copy and paste text are not available.
Only the system credentials of the VNC Server owner (the user starting VNC Server) can be used to authenticate to VNC Server. To enable other VNC Viewer users to connect without sharing the owner’s system credentials, change the authentication scheme to VNC password.
VNC Server can only remote a single output (screen). In User Mode, only the screen containing the mouse cursor at the point you started VNC Server is remoted. In Virtual Mode, a single screen is created, the resolution of which can be controlled by appending
-geometry <W>x<H>to the
The cursor is currently captured as part of the screen image. Optimally, it should be captured separately to avoid triggering a screen update when the cursor moves.
VNC Server dialogs draw their own window decorations, since by default the Weston compositor does not. If you are using a different desktop environment that can draw window decorations, disable those of VNC Server by specifying the
WlClientDecorationsVNC parameter in the file
Each connected VNC Viewer user gets their own mouse cursor, which can be operated independently of other connected users’ cursors, and that of the Linux computer.
Feedback and support
We'd love to hear your thoughts! If you have any feedback, or if you've spotted a bug, please let us know through GitHub's issue reports page.