Guide: Connect to Hyprland via RDP

[MuNeNiCK]

P.S. 2026/06/05

Currently, I am creating an RDP server dedicated to Hyprland.
Instead of this complicated WayVNC + xrdp, please try using this.

https://github.com/MuNeNiCK/hypr-rdp

Background

Omarchy (Hyprland-based) can be accessed remotely via VNC (WayVNC), but Windows users may prefer using the built-in RDP client.
By leveraging xrdp with its VNC backend, RDP can be bridged to Hyprland through WayVNC.

RDP → xrdp → WayVNC → Hyprland

Hyprland lacks native RDP support, so xrdp uses libvnc.so to forward frames to WayVNC.

---

Setup

Install dependencies

sudo pacman -S wayvnc nasm

Configure Hyprland headless output

hyprctl output create headless VNC-1
hyprctl keyword monitor "VNC-1,1920x1080@60,auto,1"
wayvnc -o VNC-1 127.0.0.1 5900

Build and configure xrdp

git clone https://github.com/neutrinolabs/xrdp.git
cd xrdp
git checkout 4b2155b6cf80c0411ffe8b5f1f7e3e4fae09e1a8
./bootstrap && ./configure && make
sudo make install

Edit /etc/xrdp/xrdp.ini:

[Xvnc]
name=Xvnc
lib=libvnc.so
pamusername=ask
pampassword=ask
ip=127.0.0.1
port=5900
security_level=0
depth=24

Then start the service:

sudo systemctl enable --now xrdp

---

Connect via Windows RDP

• Open “Remote Desktop Connection”
• Session: Xvnc
• Use your Linux username/password
  If successful, you will see the Hyprland session.

---

Notes

• The build above uses a specific commit for RFB 3.7 compatibility with WayVNC.

• Dynamic resolution changes may cause instability.

• Ongoing discussion for native WayVNC integration:

  • Add "labwc over VNC" backend (Wayland) neutrinolabs/xrdp#3587
  • So.. Lets talk about Wayland (long term feature request and discussion) neutrinolabs/xrdp#2637

[MuNeNiCK]

Most people will probably be better off connecting directly to WayVNC using a VNC client, rather than using the xrdp + WayVNC solution.
The steps for that method are shown below.

#1284

[badbabykosh]

Can anyone else confirm this currently works?

[EmpireConsultants]

The problem with this is that you have to terminal open already in Omarchy and leave "wayvnc -o VNC-1 127.0.0.1 5900" running in it. Otherwise you can't connect with a can't create session error

[MuNeNiCK]

Currently, I am creating an RDP server dedicated to Hyprland.
Instead of this complicated WayVNC + xrdp, please try using this.

https://github.com/MuNeNiCK/hypr-rdp

[sierejw]

I am trying to use your RDP server, but when I bind it to my laptop's IP, I still cannot remote into it. Is there any other configuration that's needed?

[akshitg07]

I am also trying to rdp but it is not working.

[sudosohan]

Any idea how can we connect this through mac ?