Product: Synergy (all versions)
Operating system: Linux
When you connect a Linux client computer to the server, you will sometimes see that the status says “connected” and the mouse hovers over some parts of your client screen, but you do not see the mouse cursor. The common cause is that your Linux build is Wayland on the desktop.
How do you find out if you are using Wayland?
Open the terminal, and run the following command:
echo $XDG_SESSION_TYPE
This should return either x11 or wayland.
We introduced experimental Wayland support for Synergy recently, and so the cause of issue may be:
- Using an older version of Synergy without Wayland support
- Double check the installer, as you may have downloaded the wrong installer from our download page
- Using a Linux distro which does not have the necessary libei and libportal libraries available
Depending on the reasons above, you may need to switch to X11 to get Synergy working again.
Using X11 and still unable to see the cursor
There are some rarer cases, where you may need to make a manual change in the GDM3 configuration file to help fix the issue where the mouse cursor is not visible.
Steps:
- Open the Terminal
- Run the command
-
sudo nano /etc/gdm3/custom.conf
-
- Using the arrows, navigate to #WaylandEnable=false and then remove the # (see screenshot below)
- Press Ctrl+X to save
- Then press Y for Yes
- Ctrl+O to close nano
From:

to:
