diff --git a/docs/Interactive_Computing/OnDemand/Apps/.pages.yml b/docs/Interactive_Computing/OnDemand/Apps/.pages.yml index 62129ab64..ba558b4d2 100644 --- a/docs/Interactive_Computing/OnDemand/Apps/.pages.yml +++ b/docs/Interactive_Computing/OnDemand/Apps/.pages.yml @@ -1,5 +1,3 @@ --- nav: - - VS Code: VSCode.md - - Virtual desktop: virtual_desktop.md - "*" diff --git a/docs/Interactive_Computing/OnDemand/Apps/virtual_desktop.md b/docs/Interactive_Computing/OnDemand/Apps/virtual_desktop.md index 2477ab9bd..140a1f3eb 100644 --- a/docs/Interactive_Computing/OnDemand/Apps/virtual_desktop.md +++ b/docs/Interactive_Computing/OnDemand/Apps/virtual_desktop.md @@ -9,3 +9,38 @@ tags: # Virtual Desktop via OnDemand + +## Introduction + +The Virtual Desktop application provides a full graphical Linux desktop environment running on Mahuika, accessed through your web browser. This is useful for running applications that need a graphical user interface (GUI), visualising data, or working with tools that are not well suited to a command-line-only environment. + +## Using the Virtual Desktop + +The Virtual Desktop behaves like a standard Linux desktop. From here you can: + +- Open a terminal to run commands. +- Launch graphical applications. +- Browse files in your Mahuika home, project, and nobackup directories. + +### Copy and paste + +Copying and pasting between your local machine and the Virtual Desktop is handled through the clipboard tool in the control bar rather than the usual keyboard shortcuts. Use this panel to transfer text in and out of the session (if you have difficulty doing so with keyboard shortcuts). + +First, open the VNC sidebar by clicking the tab on the left edge of the screen. + +![Click the sidebar tab on the left edge of the Virtual Desktop](../../../assets/images/Virtual_Desktop_via_OOD_on_NeSI_0.png) + +Then click the clipboard icon to open the **Clipboard** panel, and paste your text into it. + +![The Clipboard panel open in the VNC sidebar](../../../assets/images/Virtual_Desktop_via_OOD_on_NeSI_1.png) + +## Ending your session + +When you have finished, return to the **My Interactive Sessions** page in OnDemand and click **Cancel** on the Virtual Desktop session to release the resources. Sessions will also end automatically once the requested time has elapsed. + +!!! warning + Any unsaved work in the Virtual Desktop will be lost when the session ends. Make sure to save your files to your home, project, or nobackup directory before deleting the session. + +## External documentation + +- [Mahuika OnDemand](https://ondemand.nesi.org.nz/) diff --git a/docs/assets/images/Virtual_Desktop_via_OOD_on_NeSI_0.png b/docs/assets/images/Virtual_Desktop_via_OOD_on_NeSI_0.png new file mode 100644 index 000000000..6f807d9c2 Binary files /dev/null and b/docs/assets/images/Virtual_Desktop_via_OOD_on_NeSI_0.png differ diff --git a/docs/assets/images/Virtual_Desktop_via_OOD_on_NeSI_1.png b/docs/assets/images/Virtual_Desktop_via_OOD_on_NeSI_1.png new file mode 100644 index 000000000..3307846e0 Binary files /dev/null and b/docs/assets/images/Virtual_Desktop_via_OOD_on_NeSI_1.png differ