Skip to main content

Remote Desktop for Linux phones running postmarketOS using Wayland Protocol

Categories   Smartphone Linux Phone
Tags   Linux PostmarketOS
Table of Contents


When we want to use desktop mode, we would need to setup a remote desktop. Because usb ports will not working on Android phones running postmarketOS.

The VNC server would be an easy solution, however what if the Linux mobile distro uses Wayland protocol instead of X11? It will be hard for remote accessing. Fortunately there are still some workarounds.


For GNOME desktop, there is a feature named “Desktop sharing”. Turn it on in System settings → Sharing → Desktop sharing. After that, open Remmina client or RealVNC Viewer on your desktop, input IP of the phone and connect to it.

Phosh, Plasma Mobile, Sway

There “WayVNC” is the Wayland implementation of vnc server. The biggest disadvantage of WayVNC is that it will make the phone huge lag and there is no way to adjust resolutions.

  1. Install wayvnc:
sudo apk add wayvnc
  1. Enable these options at `/etc/ssh/sshd_config':
AllowTcpForwarding yes
X11Forwarding yes
  1. Restart sshd services:
sudo rc-service sshd restart
  1. Start WayVNC. Press Ctrl + C to stop.
wayvnc localhost 5901
  1. On your desktop, start a SSH connection to the phone:
ssh -L 5901:localhost:5901 [email protected]
  1. Open Remmina client, connect to the VNC server:


Netboot: Booting postmarketOS from the Internet
Categories   Smartphone Linux Phone
Tags   PostmarketOS
Playing x86 Steam games on ARM Linux devices using Box86 + Wine
Categories   Smartphone Linux Phone
Tags   PinePhone Wine
[Root] Running docker container on Redmi Note 5 Pro
Categories   Smartphone Root and Custom Rom
Tags   Termux Android Linux Docker

Leave a comment

Choose the comment system you like. Giscus for codes, Disqus for anonymous comments.

Please login to your Github account to leave a comment. You can post codes here for discussion. For images, please upload to Imgur and copy links. Your comments would be visible to everyone on Github Discussions.

This comment system is provided by Disqus, you may see forcing Disqus ADs on this page. Sometimes your comment may need to be reviewed, resulting in delayed display. Thank you for your understanding.