Install AI Workbench Locally on Ubuntu
Use this documentation to install, update, or uninstall NVIDIA AI Workbench on your local computer running Ubuntu. To review important considerations before you start, see Install AI Workbench.
Use this documentation to perform the following tasks:
Ubuntu 24.04 or 22.04
The
fuse3andlibfuse2packages to support AppImage500 MB of disk space for the AI Workbench application
30-40 GB of disk space for containers
16 GB of RAM
Use the following procedure to install AI Workbench on your local computer running Ubuntu.
Do not run the AI Workbench installation as the root user.
Install fuse by running the following command. It’s safe to run this command if fuse is alread installed.
sudo apt install fuse3 libfuse2
Download AI Workbench, make it executable, and then run it. Make it executable in a terminal by running
chmod +x local/path/to/download.WarningBefore 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.
(optional) If your computer has an NVIDIA GPU but no drivers installed, AI Workbench detects this and offers to install the latest drivers for you. For more information, see NVIDIA GPU and Drivers.
If you select this option, you need to reboot the computer after the drivers are installed.
If you want to install the latest drivers yourself, then stop the installation, install them, and reboot the computer.
After you reboot, restart the AI Workbench installation by double-clicking the NVIDIA AI Workbench icon on your desktop.
Choose Docker or Podman as your container runtime. For more information, see Container runtime options. AI Workbench installs the option you select.
(Optional) Connect AI Workbench to your Git server account. If you skip this step now, you must enter Git Author information when you are prompted. If you skip this step now, you can connect to Git later through the Settings menu. For more information, see Connect to Git.
AI Workbench opens.
Use the following procedure to update AI Workbench on your computer running Ubuntu.
When a new update for AI Workbench is available, the Update Available window appears with details about the new version when you open AI Workbench.
TipThe Update Available window might be behind the AI Workbench window if the AI Workbench window is maximized.
Click Update Now. AI Workbench begins downloading the new files, and the progress appears in the window. After the download completes, the message Restart required appears.
Click Restart Now to restart AI Workbench. AI Workbench reopens automatically.
After you update AI Workbench on your local computer, you must also update any connected remote locations. For details, see Update AI Workbench on a Remote Computer.
Use the following procedure to uninstall AI Workbench from your local computer running Ubuntu.
Drivers are not uninstalled, even if AI Workbench installed them for you.
In a command shell, run the the following command.
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.
rm -rf $HOME/.nvwb
(Optional) Iif you want to remove your project repositories, run the following command.
rm -rf $HOME/nvidia-workbench/
Delete the NVIDIA-AI-Workbench-x86_64.AppImage file from the location where you downloaded it when you installed AI Workbench.
Do a Quickstart
Explore the NVIDIA Developer Forum
Learn the Concepts