Linux FAQs

If you run into some issues when using Splashtop with Linux, have a look at our most frequently asked questions below to find some answers.

Why do I get a black screen when connecting to a headless Linux server? 

A: When connecting to a headless Linux server, it'll cause your GPU to stop producing an image, which will result in a black screen as there is nothing for Splashtop to capture. Possible solutions are:

  1. Make sure you're running Splashtop Streamer v3.0.4.0 or later (download link) and with LightDm installed as Display manager. Splashtop streamer will automatically detect it as a virtual display.

    ⚠️ Splashtop doesn't support display managers that are not LightDM, please refer to this article on How to Change the Default Display Manager in Ubuntu 20.04 (The default display manager of Ubuntu16.04 is “LightDM”).

  2. Change it to the recommended resolution as other resolutions might result in display issues
    a) Open the Business app biz_icon_en-us.png
    b) Click/tap on the edit icon next to the computer, normally a gear shaped icon
    Resolution_setting_en-us.png
    c) On the Resolution setting, choose "Native resolution of remote computer". Resolution_en-us.png

  3. Get a dummy HDMI device for the headless Linux server.
Why do I get an "The user is not an administrator. Please try again" error when logging in?
login_en-us.png
A: Although the system account might have the admin privilege, it's possible that it's not under the group admin, resulting in the login error.

For CentOS / RedHat / Fedora:  Users should be under group “adm” or “wheel”
For Ubuntu: Users should be under group “adm” or “sudo”
You can verify the sudo privilege with the command $ sudo -v.
The display server (X window) of my Linux is not Xorg.
A: Splashtop requires Xorg environment to run Splashtop streamer (Wayland is not supported at this moment). Please refer to below articles for switching to different environment:

Ubuntu - https://itsfoss.com/switch-xorg-wayland/ 
RHEL - https://www.redhat.com/en/blog/red-hat-enterprise-linux-8-gnome-and-display-server-changes
Fedora - https://docs.fedoraproject.org/en-US/quick-docs/configuring-xorg-as-default-gnome-session/
The EU keyboard mapping doesn't work when connecting to a Linux server remotely.
A: Please submit a support ticket and contact our support for workarounds.

 

 

0 out of 16 found this helpful