diff --git a/infra/docs/remote-desktop.md b/infra/docs/remote-desktop.md new file mode 100644 index 0000000000..e4408f3d00 --- /dev/null +++ b/infra/docs/remote-desktop.md @@ -0,0 +1,32 @@ +## Setting up a remote desktop + +This is handy, e.g., when creating test environments with large disks, where we +still need a graphical session to run the desktop app. + +Create a vanilla non-graphical Ubuntu instance (these steps should work for +other distros too, the commands will change). + +Install + +- **Xfce4** - The desktop environment +- **xorg** - An X server +- **xrdp** - A remote desktop protocol (RDP) server. + +```sh +sudo apt install xfce4 xorg xrdp +``` + +Configure xrdp to use Xfce + +```sh +echo xfce4-session > ~/.xsession +``` + +Start the xrdp service, and also enable it so that it starts on boot + +```sh +sudo systemctl enable xrdp +sudo systemctl start xrdp +``` + +On macOS, install a RDP client, e.g. [Microsoft Remote Desktop](https://apps.apple.com/us/app/microsoft-remote-desktop/id1295203466).