Managing Locations in the Desktop Application

Prerequisites for Remote Locations

  • The remote system must be Ubuntu 22.04, NVIDIA AI Workbench must already be installed, and the system must be switched on and available via SSH. For installation, see here in the Installation section.

  • The SSH key cannot be password protected. To set up your passwordless SSH access to the remote system, follow these general instructions:

    1. Execute cd /home/user && ssh-keygen on the local system to create an SSH key pair. Follow the prompts for key name, eg. /home/user/.ssh/id_rsa, and leave the password prompt empty.

    2. From the local system, add the public key to the .ssh/authorized_keys file on the remote system.

      • On Powershell:


        type$env:USERPROFILE\.ssh\ | ssh user@ "cat >> .ssh/authorized_keys"

      • On MacOS or Ubuntu:


        ssh-copy-id user@


    If you already have an SSH key that is passwordless on your local machine, you can use that. However, if you do not have an SSH key or if you have an SSH key that has a password, you will need to generate a new SSH key that is passwordless.

    • The IP Address and SSH username must be known, the SSH private key saved on your local system, and the SSH public key must added to your remote system.

  • To use a Remote Location you must first add it to your Local AI Workbench. You can add multiple Remote Locations.

  • Once a Location is added, you can work on it by selecting it from the My Locations page. This activates the Location and opens a window for that Location.

  • Closing the window deactivates the Location if no other windows are connected to that location.

Adding a Remote Location

Select the Add Remote Location button on the top right of the My Locations landing page and fill in the details of the remote Location, and then click Add Location to finish.


  • A unique name for the Remote Context

  • A brief description of the Remote Context

  • The Hostname or IP of the desired remote system

  • The SSH username for accessing the Remote system

  • The absolute path to the SSH private key on your local system

  • (Optional) The absolute path to the .nvwb directory on the Remote system. The default value that gets populated here should be correct for a default install.

Example Output:


What can go wrong:

  • The prerequisites were not satisfied.

Activating a Location

To activate a Location, select it from the My Locations landing page. This opens (or redirects) to a new page with a list of all Projects on disk in that Location.


Example Output:


What can go wrong:

  • The remote system is not running or is no longer SSH accessible.

Deactivating a Location

To deactivate a Location, just close the Location window.


Modifying Location Metadata

Expand the three dots on the right-hand edge of your intended context of the Location you want to delete, select Edit Location and fill in the relevant and editable details. Then select Modify Location to confirm.


Example Output:


What can go wrong:

  • For changes to save properly, AI Workbench must be able to validate the connection to the Location.

  • For the local location, only the description can be modified.

Deleting a Remote Location

To delete a remote context, expand the three dots on the right-hand edge of the Location you want to delete, and select Delete Location and confirm your selection. Note that this only removes the location from your AI Workbench client. It does not delete data or uninstall anything on the remote location.


Example Output:

  • NA

What can go wrong:

  • NA

Previous Desktop Application Basics
Next Configuring Integrations in the Desktop Application
© Copyright 2023-2024, NVIDIA. Last updated on Jan 21, 2024.