Install AI Workbench Remotely on Ubuntu

Use this documentation to install, update, or uninstall NVIDIA AI Workbench on your remote computer running Ubuntu. To review important considerations before you start, see Install AI Workbench.

Use this documentation to perform the following tasks:

Prerequisites

Ubuntu 24.04 or 22.04
SSH access as a non-root user with sudo privileges by using a public/private key pair.
500 MB of disk space for the AI Workbench application
30-40 GB of disk space for containers
16 GB of RAM

Install AI Workbench on a remote computer

Use the following procedure to install AI Workbench on your remote computer running Ubuntu.

From a terminal on your local computer, SSH to the remote computer. You can use a password or private key for this step.

Warning

Do not ssh to the remote computer as the root user.
Run the following command.

Warning

Before downloading, please read the NVIDIA AI Product Agreement, the NVIDIA AI Workbench Shared Security Model, and our Data Privacy Policy.

By downloading, installing, or using the NVIDIA AI Workbench software, you agree to the terms of the NVIDIA AI Product Agreement (EULA). If you do not agree to the terms of the EULA, you are not authorized to download, install, or use NVIDIA AI Workbench. Before downloading and using NVIDIA AI Workbench, please read our Shared Security Model.
Copy

Copied!
```
            
            mkdir -p $HOME/.nvwb/bin && \
curl -L https://workbench.download.nvidia.com/stable/workbench-cli/$(curl -L -s https://workbench.download.nvidia.com/stable/workbench-cli/LATEST)/nvwb-cli-$(uname)-$(uname -m) --output $HOME/.nvwb/bin/nvwb-cli && \
chmod +x $HOME/.nvwb/bin/nvwb-cli && \
sudo -E $HOME/.nvwb/bin/nvwb-cli install
        
```
A text-based interface starts.

Note

Instead of using the interactive guide, you can use the install command and specify all flags. For details, run nvwb install -h.
The text-based interface guides you through the remote installation.
- You can advance through the installation by using the arrow keys to select different options and pressing Enter to select options.
- If the computer has an NVIDIA GPU but no drivers installed, AI Workbench detects this and asks you if you want the drivers installed for you. If you choose yes, the drivers are installed and you reboot the computer in a later step.
Choose Docker or Podman as your container runtime. For more information, see Container runtime options. AI Workbench installs the option you select.
If you chose to have drivers installed during the installation, reboot the computer.
Now you can connect to the remote computer from your local AI Workbench.

Important

After you install AI Workbench on a remote computer, you have to connect to the remote computer from your local computer one time. After that, the remote computer appears as a Location whenever you open AI Workbench locally. For instructions, see Connect to a Remote Location.

Update AI Workbench on a remote computer

Use the following procedure to update AI Workbench on your remote computer running Ubuntu.

From a terminal on your local computer, SSH to the remote computer. You can use a password or private key for this step.

Warning

Do not ssh to the remote computer as the root user.

Run the following command to download the latest version of AI Workbench.

Copy
Copied!

            
            mkdir -p $HOME/.nvwb/bin && \
curl -L https://workbench.download.nvidia.com/stable/workbench-cli/$(curl -L -s https://workbench.download.nvidia.com/stable/workbench-cli/LATEST)/nvwb-cli-$(uname)-$(uname -m) --output $HOME/.nvwb/bin/nvwb-cli && \
chmod +x $HOME/.nvwb/bin/nvwb-cli && \
sudo -E $HOME/.nvwb/bin/nvwb-cli install

A text-based interface starts.

The text-based interface guides you through the update.
- You can advance through the update by using the arrow keys to select different options and pressing Enter to select options.
Confirm Docker or Podman as your container runtime.
Now you can connect to the remote computer from your local AI Workbench.

Uninstall AI Workbench on a remote computer

Use the following procedure to uninstall AI Workbench from your remote computer running Ubuntu.

Note

Drivers are not uninstalled, even if AI Workbench installed them for you.

From a terminal on your local computer, SSH to the remote computer. You can use a password or private key for this step.

Warning

Do not ssh to the remote computer as the root user.

Run the the following command.

Copy
Copied!

            
            sudo -E $HOME/.nvwb/bin/nvwb-cli uninstall

You are prompted to confirm that you want to uninstall AI Workbench. Type y and press enter.

Wait for the uninstall to complete before you proceed with the following steps.
(Optional) If you want to remove the application files, run the following command to remove the .nvwb folder.
Copy

Copied!
```
            
            rm -r $HOME/.nvwb
        
```
(Optional) Iif you want to remove your project repositories, run the following command.
Copy

Copied!
```
            
            rm -r $HOME/nvidia-workbench/
        
```

Install AI Workbench Remotely on Ubuntu

Prerequisites

Install AI Workbench on a remote computer

Update AI Workbench on a remote computer

Uninstall AI Workbench on a remote computer

Next Steps