Cumulocity instructions on how to configure wayvnc so that it is compatible with the Cumulocity VNC client and thin-edge.io

Cumulocit-CloudRemoteAccess-VNC-wayland.md

Cumulocity Cloud Remote Access - VNC

Pre-requisites

• Cumulocity cloud-remote-access >= 2.0.33

Configuring wayvnc (used in Wayland) with Cumulocity

The following instructions can be used to configure the wayvnc service so that it is compatible with the Cumulocity VNC viewer. These instructions will disable the authorization, however to keep the setup secure, it will only establish a listener on localhost (127.0.0.1) which will not allow other devices/services/applications in the network to connect to it. The VNC server will then be accessed securely via Cumulocity and the connection to thin-edge.io (which is encrypted).

Following these instructions to setup wayvnc and Cumulocity.

1. Edit the wayvnc configuration file (you will need to have root access rights to edit the file)

   /etc/wayvnc/config

   Add add the following contents:

   use_relative_paths=true
   address=127.0.0.1
   enable_auth=false
   enable_pam=false
   username=
   password=
   private_key_file=tls_key.pem
   certificate_file=tls_cert.pem
   rsa_private_key_file=rsa_key.pem

2. Restart the wayvnc service

   sudo systemctl restart wayvnc

3. In the Device Management UI, create a new remote access endpoint with the VNC type

   Property	Value
   Name	webvnc (but you can change this)
   Port	5900
   Sign-in method	No password

   Or if you're a go-c8y-cli user, then you can create it using the command line

   c8y remoteaccess configurations create-vnc --name webvnc --port 5900 --device "example_device"

4. In the Device Management UI, open a VNC session within the UI

Tested on

• Debian 13 (trixie), waylan 0.9.1-1+rpt4