From 11c3ec0783d22facc71a4fe6e441e73fe6fbb4b8 Mon Sep 17 00:00:00 2001
From: Konrad Bucheli <konrad.bucheli@psi.ch>
Date: Thu, 13 Jul 2023 11:45:37 +0200
Subject: [PATCH] properly link the stuff

---
 admin-guide/configuration/xrdp.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 admin-guide/configuration/xrdp.md

diff --git a/admin-guide/configuration/xrdp.md b/admin-guide/configuration/xrdp.md
new file mode 100644
index 00000000..22e32bdd
--- /dev/null
+++ b/admin-guide/configuration/xrdp.md
@@ -0,0 +1,30 @@
+# RDP Remote Access with XRDP
+
+Note: this currently only works with RHEL8.
+
+The basic configuration in Hiera is:
+
+```
+xrdp::enable: true
+```
+
+This allows by default to create new virtual desktop sessions or to connect to a local desktop session which is shared over VNC using port 5900.
+
+Some more details could be ajusted when needed:
+
+To disallow access to a shared desktop do
+```
+xrdp::shared_desktop::enable: false
+```
+
+whereas to disallow virtual desktop sessions there is
+
+```
+xrdp::virtual_desktop::enable: false
+```
+
+Also you may choose the backend for the virtual sessions, either `libxup.so` (default) or `libvnc.so`:
+
+```
+xrdp::virtual_desktop::backend: 'libvnc.so'
+```