AI Workbench Container Runtimes

NVIDIA AI Workbench builds and runs a unique container for each of your Workbench projects. By using containers, you can switch between different environments and configurations, without worrying about conflicts or compatibility issues. You choose a container runtime when you install AI Workbench.

Use this documentation to learn about the following:

• Docker

• Podman

• Change Your Container Runtime

Docker is a popular, all-in-one platform for creating, managing and deploying containers. Depending on your company size and revenue, you might need a paid license to use Docker. Docker uses a client-server architecture, with the docker daemon running as a persistent background process.

Podman is an open-source container runtime and management tool originally developed by Red Hat. Podman employs a daemon-less architecture, and launches containers as child processes that do not require superuser privileges. AI Workbench uses rootless Podman.

You choose a container runtime when you first install AI Workbench. If you want to change your container runtime, use the following procedure.

1. Close the AI Workbench desktop application, or in the CLI run nvwb deactivate <local or remote context>.

2. Open a command shell by doing one of the following:

   • On macOS or Ubuntu — Open your favorite command shell, such as terminal.

   • On Windows — Open the WSL app by searching for WSL in your app list. When the WSL app opens, you should see a command prompt similar to the following:

     Copy

     Copied!

                 
     
                 
     workbench@computer-name:~$
             

     Tip

     You can also use Terminal, Command Prompt, or Windows PowerShell, and access WSL by using the command wsl -d NVIDIA-Workbench.

3. Enter the command cd ~/.nvwb.

4. Run the command ls and verify that you see the file config.yaml.

5. Use your favorite editor to open the file config.yaml. For example, run the following code.

   Copy

   Copied!

               
   
               
   nano config.yaml
           

6. Edit the buildtime and runtime entries to the container runtime that you prefer. Both entries must match. Valid values are docker and podman.

   Copy

   Copied!

               
   
               
   container:
       buildtime: podman
       runtime: podman
           

7. Save your changes and close the file.

   Your default container runtime is now set to the new runtime.

8. Restart the AI Workbench desktop application, or in the CLI run nvwb activate <local or remote context>.

   Note

   The next time you open AI Workbench it might prompt you to install or configure it.

   Important

   On macOS and Windows, you must rebuild existing projects after you change your container runtime.

• Troubleshoot AI Workbench