From 337ef883f88979864d2912435be236ae0cc088b1 Mon Sep 17 00:00:00 2001
From: ebner <simon.ebner@psi.ch>
Date: Tue, 13 Jan 2026 17:28:38 +0100
Subject: [PATCH] Update docs/user-guide/consoles.md

---
 docs/user-guide/consoles.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/user-guide/consoles.md b/docs/user-guide/consoles.md
index 89707265..089f3654 100644
--- a/docs/user-guide/consoles.md
+++ b/docs/user-guide/consoles.md
@@ -69,3 +69,24 @@ If e.g. a person need to deploy some software into `/<facility>/<beamline>/appli
 2. Give the person the ownership of that directory: `chown whatever-user /<facility>/<beamline>/applications/<whatever>`
 
 Now `whatever-user` can write files in `/<facility>/<beamline>/applications/<whatever>` and deploy his/her software.
+
+## RDP Access
+
+Consoles with RDP enabled can be accessed from the PSI intranet as follows:
+
+1. Open an SSH Tunnel via the beamline gateway:
+```bash
+ssh -L 3389:<your-console>.psi.ch:3389 <your-gateway>
+
+# replace <your-console> and <your-gateway> according to your beamline
+# example: ssh -L 3389:x00da-vcons-test-01:3389 x00da-gw
+```
+2. Open an RDP client and connect to `localhost`
+
+From outside PSI the connection can be established via hopx.psi.ch. this can be done as follows:
+
+1. Open an SSH Tunnel via hopx and your beamline SSH gateway
+```bash
+ssh -J hopx.psi.ch -L 3389:<your-console>.psi.ch:3389 <your-gateway>
+```
+2. Open an RDP client and connect to `localhost`
\ No newline at end of file