Skip to content

docs(rdp): add documentation on how to use RDP #690

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions bitbots_misc/bitbots_docs/docs/manual/tutorials/remote_desktop.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
=====================
Remote Desktop Access
=====================

Since the upgrade to Ubuntu 24.04, which is using gnome-shell >= 46, it supports integrated remote desktop access over RDP.
But because the cls are not directly accessible via the internet, we need to use a tunnel to access them.
Until we have a better solution, we can just use an SSH tunnel over the university jump hosts `{rzssh1, rzssh2}.informatik.uni-hamburg.de`.

So using the normal external SSH access `uni-jump-host -> rzrobo3 -> cl0*` we can create a tunnel on a specific port, which we can then use to connect to the remote desktop:

.. code-block:: bash
ssh -CL 3389:cl06:3389 rzrobo3 -N

This will forward the RDP port 3389 from the remote desktop of `cl06` to your local machine's port 3389,
then allowing you to connect to it using an RDP client like `Remmina` or `Microsoft Remote Desktop` with `127.0.0.1:3389` as the address.
**This assumes that you have an SSH config set up for `rzrobo3`, which uses the university jump hosts.**

The remote desktop login is using the user `bitbots` and the password is located in our vault under "Gnome RDP Login".
Loading