For the complete documentation index, see llms.txt. This page is also available as Markdown.

Desktop App (VNC)

The Desktop app on Open OnDemand is a replacement for the older VNC Java client. This app allows you to launch a Desktop GUI on Oscar.

Advanced users looking for more resources can try the Desktop (Advanced) app.

Launching Desktop App (VNC)

0. Launch Open OnDemand

Launch Open OnDemand (OOD) and log in with you Brown Credentials.

1. Select the Desktop option in Interactive Apps dropdown list:

Screenshot of the Oscar OpenOnDemand Portal showing the Interactive Apps dropdown menu open with the Desktop option circled in red.

2. Choose the resource option:

Desktop app resource configuration form showing a dropdown menu with several resource presets for cores, memory, and duration.

3. Wait and Launch! (VNC)

Desktop session management page showing a running session with a blue Launch Desktop button highlighted by a red circle and arrow.

You may change the Image Quality if your internet connection is bad. Image quality can be changed in the middle of the session.

Image Quality slider in the Desktop session management interface, highlighted with a red box and arrow.

Reconnecting to session

A session may get disconnected if it is not active for a while:

Browser screen showing a Disconnected message from the noVNC client with a Connect button.

If the session disconnects as shown above, please don't click the "Connect" button on the screen. You may go to Open OnDemand page and click “My Interactive Sessions” to find the session again:

Screenshot of the OpenOnDemand navigation bar with My Interactive Sessions circled in red.

Sometimes, the “My interactive Sessions” button is shortened to look like:

A small blue button with a white icon representing My Interactive Sessions on smaller screens.

Copying and pasting text

If you are using Google Chrome, switch on the "Clipboard" permission and you can directly copy and paste text into the OOD Desktop from any other program.

  1. Click the Lock icon to the left of the URL

  2. Switch on the "Clipboard" permission

Google Chrome site permissions dialog showing the Clipboard toggle switched to the on position.

Desktop (Advanced)

If you need more or different resources than those available from the default Desktop session, you should use the Advanced Desktop app. Resources requested here count against the resources allowed for your Oscar account.

1. Select the Desktop (Advanced) app under Interactive Apps.

OpenOnDemand navigation bar with 'Interactive Apps' item expanded and the 'Desktop (Advanced)' dropdown item highlighted. The 'Interactive Apps' item is circled and labeled with a 1 and the 'Desktop (Advanced)' is circled and labeled with a 2.

2. Choose required resources

Fill out the form with your required resources.

  • Account: Enter your condo account name. If you are not a member of a condo, leave this blank

  • Desktop Environment: Choose XFCE. KDE works for CPU jobs, but may not be able to use GPU acceleration correctly.

  • Number of hours: Choose appropriately. Your Desktop session will end abruptly after this time has lapsed. Requesting a very long session will result in a lower job priority.

  • Partition: Equivalent to #SBATCH -p option. The desktop session will run on this partition.

  • Num Cores: Equivalent to the #SBATCH -n option.

  • Num GPUs: Equivalent to the #SBATCH --gres=gpu: option. This field is ignored if the partition does not have any GPU nodes, e.g. batch

  • Memory (GB): Equivalent to the #SBATCH --mem= option.

  • Reservation: Equivalent to the #SBATCH --reservation= option. Leave blank if you are not using a reservation.

3. Wait and Launch (Advanced)!

Wait and launch this session like the regular Desktop session.

Modify the Terminal App

Inside the Desktop session , click on Applications in the top left

Applications -> Settings -> Default Applications

The XFCE Applications menu showing the path through Settings to the Default Applications option.

In the new Window, click on the "Utilities" tab and choose "Gnome Terminal" in the drop down menu under "Terminal Emulator"

The Default Applications settings window with the Utilities tab selected and GNOME Terminal chosen as the default Terminal Emulator.

Then click on "Applications -> Terminal Emulator" to launch the terminal:

The Applications menu in the Desktop session with the Terminal Emulator option circled in red.

If the steps mentioned above do not work:

  1. Close the Desktop session

  2. Inside a terminal (outside the Desktop session), run this command:

  3. Start a new desktop session.

Change the Terminal icon for launcher panel

Please drag and drop the "Terminal Emulator" icon from the "Applications" menu to the launcher panel at the bottom of the screen, it will be inserted to the launcher panel:

Screenshot showing how to drag the Terminal Emulator from the Applications menu to the bottom launcher panel.

Then click on "Create Launcher":

The Create Launcher dialog box with the Create Launcher button circled in red.

You may remove the old terminal icon after adding the new icon:

Context menu on a launcher icon in the panel with the Remove option circled in red.

Last updated

Was this helpful?