AI Workbench Error Codes Reference#
This document provides a reference for the error codes that may occur when using the AI Workbench Desktop App and CLI.
Overview#
AI Workbench recently implemented error codes to help users resolve issues when they arise.
Not all errors have codes, and not all errors with codes can be resolved.
The error message provides a description of the problem and potential resolution steps when available.
Error codes indicate where and when a failure occurred in the application. They may not identify the root cause or provided specific resolution steps.
All errors in the Desktop App will show a system log, which is not the error message.
Some system logs are very obscure, but others have clear and actionable information in them.
Analyzing the system log with an LLM may help identify the issue, though results vary.
When you get an error code, come to this page and find the relevant information.
Error codes in the Desktop App should link to the appropriate section in this page. However, you can also just come to the page and use CTRL + F to find the code.
Key Concepts#
- Error Message:
The actual text you will see in the application corresponding to the error code.
- OS/Location:
Identification of which operating system or location type (local/remote) that will show the code.
- Explanation:
Extra information not in the error message that provides context and potential troubleshooting information for the error.
Error Code by Component#
CLI Errors#
0x30030001#
Unknown Filesystem Error
Error Message: An unexpected filesystem error occurred in the CLI component.
OS/Location:
Explanation:
0x30040001#
Unknown Internal Error
Error Message: An unexpected internal error occurred in the CLI component.
OS/Location:
Explanation:
0x30020001#
Unknown Network Error
Error Message: An unexpected network error occurred in the CLI component.
OS/Location:
Explanation:
0x30020002#
Unable to download binaries during install
Error Message: Failed to start download. Make sure you’re connected to the internet and try re-running the Workbench install.
OS/Location:
Explanation:
0x30020003#
Incomplete Brev bootstrap during remote-only install
Error Message: Failed to configure Workbench on the Brev host.
Either retry the Workbench install or manually configure the Brev remote. The host can be accessed with ssh <hostname/IP>.
Running the following command on the host will show the log output from the failed install:
cat ~/.nvwb/logs/workbench.log
If container toolkit failed to update due to how some cloud providers pin the version you may need to manually run the following command:
sudo apt --only-upgrade --allow-change-held-packages install nvidia-container-toolkit nvidia-container-toolkit-base
OS/Location:
Explanation:
0x30020004#
Incomplete Brev bootstrap during remote-only install
Error Message: Failed to configure Workbench on the Brev host.
Either retry the Workbench install or manually configure the Brev remote. The host can be accessed with ssh <hostname/IP>.
Running the following command on the host will show log output from the failed install:
cat ~/.nvwb/logs/workbench.log
If container toolkit failed to update due to how some cloud providers pin the version you may need to manually run:
sudo apt --only-upgrade --allow-change-held-packages install nvidia-container-toolkit nvidia-container-toolkit-base
OS/Location:
Explanation:
0x30020005#
Incomplete Brev bootstrap during remote-only install
Error Message: Brev is not currently supported for remote installs from Windows.
OS/Location:
Explanation:
0x30020006#
Install Failed Due to Incomplete Download
Error Message: Did not complete download for a Workbench binary. Check your internet connection and retry the installation.
If it fails again, contact support.
OS/Location:
Explanation:
0x30050001#
Unknown ProjectSpec Error
Error Message: An unexpected project specification error occurred in the CLI component.
OS/Location:
Explanation:
0x30010001#
Unknown Validation Error
Error Message: An unexpected validation error occurred in the CLI component.
OS/Location:
Explanation:
0x30010002#
Install Failed Due to Failed Binary Integrity Check
Error Message: Failed to verify integrity of a Workbench binary. Retry the installation.
If it fails again, contact support.
OS/Location:
Explanation:
0x30010003#
Install on Remote Brev Host Failed
Error Message: Could not complete the install of AI Workbench on the remote Brev host.
OS/Location:
Explanation:
Credential Manager Errors#
0x40030001#
Unknown Filesystem Error
Error Message: An unexpected filesystem error occurred in the CREDENTIAL_MANAGER component.
OS/Location:
Explanation:
0x40040001#
Unknown Internal Error
Error Message: An unexpected internal error occurred in the CREDENTIAL_MANAGER component.
OS/Location:
Explanation:
0x40040002#
JSON Parse Error
Error Message: Failed to parse JSON response from the external service. The response may be malformed.
OS/Location:
Explanation:
0x40020001#
Unknown Network Error
Error Message: An unexpected network error occurred in the CREDENTIAL_MANAGER component.
OS/Location:
Explanation:
0x40020002#
Service Unreachable
Error Message: Unable to connect to the external service. This may be due to network connectivity issues or the service being temporarily unavailable.
OS/Location:
Explanation:
0x40020003#
Request Timeout
Error Message: The request to the external service timed out. Check your network connection and try again.
OS/Location:
Explanation:
0x40020004#
Service Unavailable
Error Message: The external service is temporarily unavailable. Please try again later.
OS/Location:
Explanation:
0x40020005#
OAuth Authentication Failed
Error Message: Failed to complete OAuth authentication flow. This may be due to network issues or service problems.
OS/Location:
Explanation:
0x40020006#
Profile Query Failed
Error Message: Failed to retrieve user profile information from the external service. Check your network connection and try again.
OS/Location:
Explanation:
0x40020007#
Token Refresh Failed
Error Message: Failed to refresh the authentication token. Check your network connection and try again.
OS/Location:
Explanation:
0x40020008#
API Communication Error
Error Message: Failed to communicate with the integration API. Check your network connection and try again.
OS/Location:
Explanation:
0x40050001#
Unknown ProjectSpec Error
Error Message: An unexpected project specification error occurred in the CREDENTIAL_MANAGER component.
OS/Location:
Explanation:
0x40010001#
Unknown Validation Error
Error Message: An unexpected validation error occurred in the CREDENTIAL_MANAGER component.
OS/Location:
Explanation:
0x40010002#
Invalid Credentials
Error Message: The provided credentials are invalid or have been revoked. Please reconnect to the integration.
OS/Location:
Explanation:
0x40010003#
Access Forbidden
Error Message: Access to the requested resource is forbidden. Check your permissions and try again.
OS/Location:
Explanation:
0x40010004#
Token Expired
Error Message: Your authentication token has expired. Please reconnect to the integration.
OS/Location:
Explanation:
0x40010005#
Invalid Integration Name
Error Message: The specified integration name is not recognized. Check the integration name and try again.
OS/Location:
Explanation:
0x40010006#
Connection Already Exists
Error Message: A connection to this integration already exists. Disconnect first if you want to reconnect.
OS/Location:
Explanation:
0x40010007#
Invalid Credential Format
Error Message: The credential format is invalid. Please check the format and try again.
OS/Location:
Explanation:
0x40010008#
Missing Required Arguments
Error Message: Required arguments are missing. Please provide all required arguments.
OS/Location:
Explanation:
0x40010009#
Invalid URL Format
Error Message: The provided URL format is invalid. Please check the URL and try again.
OS/Location:
Explanation:
0x4001000A#
OAuth Not Supported
Error Message: OAuth authentication is not supported for this integration. Please use a personal access token instead.
OS/Location:
Explanation:
0x4001000B#
OAuth Flow Failed
Error Message: The OAuth authentication flow failed. Please try again.
OS/Location:
Explanation:
0x4001000C#
Invalid Token
Error Message: The provided token is invalid. Please check the token and try again.
OS/Location:
Explanation:
Desktop App Errors#
0x10070001#
Unknown Application Error
Error Message: An unexpected error occurred while in the Desktop Application.
OS/Location:
Explanation:
0x10070002#
Unknown Application Error
Error Message: An unexpected error occurred while quitting the Desktop Application.
OS/Location:
Explanation:
0x10030001#
Unknown Filesystem Error
Error Message: An unexpected filesystem error occurred.
OS/Location:
Explanation:
0x10030002#
Filesystem Error
Error Message: Could not create the .nvwb/bin directory.
OS/Location:
Explanation:
0x10030003#
Filesystem Error
Error Message: Could not move the AI Workbench Service binary (wb-svc) to the .nvwb/bin directory.
One possible fix is to try the following:
Restart your computer and try again.
If it fails again, contact support.
OS/Location:
Explanation:
0x10030004#
Filesystem Error
Error Message: Could not move the AI Workbench CLI binary (nvwb-cli on macOS/Linux/WSL; nvwb-cli.exe on Windows) to the .nvwb/bin directory.
One possible fix is to try the following:
Restart your computer and try again.
If it fails again, contact support.
OS/Location:
Explanation:
0x10030005#
Filesystem Error
Error Message: Could not move the AI Workbench Credential Manager binary (credential-manager on macOS/Linux; credential-manager.exe on Windows) to the .nvwb/bin directory.
One possible fix is to try the following:
Restart your computer and try again.
If it fails again, contact support.
OS/Location:
Explanation:
0x10030006#
Filesystem Error
Error Message: Could not verify all the binaries were moved to the .nvwb/bin directory.
One possible fix is to try the following:
Restart your computer and try again.
If it fails again, contact support.
OS/Location:
Explanation:
0x10030007#
Filesystem Error
Error Message: Failed to set ownership on the .nvwb/bin directory and the workbench binaries. This may be due to permission issues with your user account.
OS/Location:
Explanation:
0x10030008#
Filesystem Error
Error Message: Failed to set permissions on the .nvwb/bin directory and the workbench binaries. This may be due to permission issues with your user account.
OS/Location:
Explanation:
0x10030009#
Filesystem Error
Error Message: Could not locate the binaries in the application bundle. This may be due to permission issues with your user account.
If it fails again, contact the support team.
The support team will normally ask you to generate the application bundle and send it to them. To learn how to generate the support bundle, see Create a Support Bundle for Troubleshooting.
OS/Location:
Explanation:
0x10040001#
Unknown Internal Error
Error Message: AI Workbench was unable to confirm the status of your system.
OS/Location:
Explanation:
0x10040002#
Locations Error
Error Message: Failed to list the AI Workbench locations on your system.
OS/Location:
Explanation:
0x10040003#
Migration Error
Error Message: An unexpected error occurred when migrating your data from Windows to the NVIDIA-Workbench distribution.``
OS/Location:
Explanation:
0x10040004#
Unexpected Internal Error
Error Message: An unexpected error occurred while trying to determine your installation type.
OS/Location:
Explanation:
0x10020001#
Unknown Network Error
Error Message: An unexpected network error occurred in the Desktop Application.
OS/Location:
Explanation:
0x10060001#
Unknown Setup Error
Error Message: An unexpected error occurred while running the local installation.
OS/Location:
Explanation:
0x10060002#
Setup Error
Error Message: Failed to run the install hook for the AI Workbench CLI.
OS/Location:
Explanation:
0x10060003#
Setup Error
Error Message: Failed to set the CLI Path in the cli.yaml file.
To fix, you must manually set the CLI Path in the cli.yaml file using the following steps:
Open the cli.yaml file in a text editor.
Set the CLI Path to the correct path.
Save the file.
Rerun the AI Workbench Local installation flow.
OS/Location:
Explanation:
0x10060004#
Setup Error
Error Message: A required dependency failed to install during desktop setup.
To fix, you must manually install the required dependency using the following steps:
Ensure you have a stable internet connection.
Check your proxy settings.
Rerun the AI Workbench Local installation flow.
OS/Location:
Explanation:
0x10060005#
Setup Error
Error Message: There was an error interacting with AI Workbench’s configuration files.
OS/Location:
Explanation:
0x10060006#
Setup Error
Error Message: An unexpected error occurred while running the local installation.
OS/Location:
Explanation:
0x10060007#
Setup Error
Error Message: An unexpected error occurred while creating your local location.
OS/Location:
Explanation:
0x10010001#
Unknown Validation Error
Error Message: An unexpected validation error occurred in the Desktop Application.
OS/Location:
Explanation:
0x10010002#
Unexpected Validation Error
Error Message: An unexpected validation error occurred when checking your OS version and type for compatibility.
OS/Location:
Explanation:
0x10010003#
UAC Error
Error Message: An unexpected error occurred when checking your UAC settings.
OS/Location:
Explanation:
0x10010004#
Admin Error
Error Message: An unexpected error occurred when checking your admin settings.
OS/Location:
Explanation:
0x10010005#
Virtualization Error
Error Message: An unexpected error occurred when checking your virtualization settings.
OS/Location:
Explanation:
0x10000001#
Unknown WSL Error
Error Message: An unexpected WSL error occurred in the Desktop Application.
OS/Location:
Explanation:
0x10000002#
WSL Error
Error Message: Failed to download the NVIDIA-Workbench distribution.
OS/Location:
Explanation:
0x10000003#
WSL Error
Error Message: Failed to install the NVIDIA-Workbench distribution.
OS/Location:
Explanation:
0x10000004#
WSL Error
Error Message: Failed to set the ‘workbench’ user in the NVIDIA-Workbench distribution.
To fix, you must re-run the installation flow using the following steps:
Unregister the NVIDIA-Workbench distribution:
wsl --unregister NVIDIA-Workbench
Re-run the AI Workbench Local installation flow.
OS/Location:
Explanation:
0x10000005#
WSL Error
Error Message: Failed to update packages; there may have been a network error during the installation of the NVIDIA-Workbench distribution.
To fix, you must re-run the installation flow using the following steps:
Unregister the NVIDIA-Workbench distribution:
wsl --unregister NVIDIA-Workbench
Re-run the AI Workbench Local installation flow.
OS/Location:
Explanation:
0x10000006#
WSL Error
Error Message: Failed to upgrade packages; There may have been a network error during the installation of the NVIDIA-Workbench distribution.
To fix, you must re-run the installation flow using the following steps:
Unregister the NVIDIA-Workbench distribution:
wsl --unregister NVIDIA-Workbench
Re-run the AI Workbench Local installation flow.
OS/Location:
Explanation:
0x10000007#
WSL Error
Error Message: Failed to install dbus package; there may have been a network error during the installation of the NVIDIA-Workbench distribution.
To fix, you must re-run the installation flow using the following steps:
Unregister the NVIDIA-Workbench distribution:
wsl --unregister NVIDIA-Workbench
Re-run the AI Workbench Local installation flow.
OS/Location:
Explanation:
0x10000008#
WSL Error
Error Message: Failed to update iptables; there may have been a network error during the installation of the NVIDIA-Workbench distribution.
To fix, you must re-run the installation flow using the following steps:
Unregister the NVIDIA-Workbench distribution:
wsl --unregister NVIDIA-Workbench
Re-run the AI Workbench Local installation flow.
OS/Location:
Explanation:
0x10000009#
WSL Error
Error Message: Failed to configure the NVIDIA-Workbench distribution; in this step we set up systemd
OS/Location:
Explanation:
0x1000000A#
WSL Error
Error Message: Failed to download the manifest file for the NVIDIA-Workbench distribution
OS/Location:
Explanation:
0x1000000B#
WSL Error
Error Message: The checksum for the NVIDIA-Workbench distribution did not match the expected checksum.
Try the following step to fix the error:
Rerun the AI Workbench local installation flow.
OS/Location:
Explanation:
0x1000000C#
WSL Error
Error Message: The check to confirm the NVIDIA-Workbench distribution is installed failed
OS/Location:
Explanation:
0x1000000D#
WSL Error
Error Message: The distribution NVIDIA-Workbench is not installed, running the WSL import command failed.
To fix, you must re-run the installation flow using the following step:
Re-run the installation flow
OS/Location:
Explanation:
0x1000000E#
WSL Error
Error Message: The NVIDIA-Workbench distribution failed to configure for an unknown reason
Delete the NVIDIA-Workbench distribution
wsl --unregister NVIDIA-Workbench
Re-run the AI Workbench Local installation flow
OS/Location:
Explanation:
0x1000000F#
WSL Error
Error Message: An error occurred while checking the status of WSL on your system
OS/Location:
Explanation:
0x10000010#
WSL Error
Error Message: An unexpected error occurred while installing WSL
Quit AI Workbench
Run the following command:
wsl --install wsl --update
Restart your computer
Re-run the AI Workbench Local installation flow
OS/Location:
Explanation:
0x10000011#
WSL Error
Error Message: GitHub is rate limiting your requests. Please try again later.
OS/Location:
Explanation:
Service Manager Errors#
0x20030001#
Unknown Filesystem Error
Error Message: An unexpected filesystem error occurred in the SERVICE component.
OS/Location:
Explanation:
0x20030002#
Project Delete Failed Due to Protected File
Error Message: Could not delete the project because it has a protected file.
This can happen if a container in the project ran as root. To fix, you must manually remove the repository using the following steps:
Open a terminal for the location
Remove the repository using the following command:
sudo rm -rf ~/nvidia-workbench/<PROJECT_NAME>
Delete the project again
OS/Location:
Explanation:
0x20040001#
Unknown Internal Error
Error Message: An unexpected internal error occurred in the SERVICE component.
OS/Location:
Explanation:
0x20040002#
Service failed to start
Error Message: The AI Workbench service failed to start. Check the service logs for more details and ensure all dependencies are properly installed.
OS/Location:
Explanation:
0x20020001#
Unknown Network Error
Error Message: An unexpected network error occurred in the SERVICE component.
OS/Location:
Explanation:
0x20050001#
Unknown ProjectSpec Error
Error Message: An unexpected project specification error occurred in the SERVICE component.
OS/Location:
Explanation:
0x20010001#
Unknown Validation Error
Error Message: An unexpected validation error occurred in the SERVICE component.
OS/Location:
Explanation:
0x20010002#
Unsupported OS
Error Message: Managed installation on this OS is not currently supported. See https://docs.nvidia.com/ai-workbench/index.html for more information.
OS/Location:
Explanation:
0x20010003#
Container runtime configuration
Error Message: Container runtime configuration failed during installation.
Ensure Docker or Podman is installed and running
Open Workbench and retry installation
Learn more: https://docs.nvidia.com/ai-workbench/user-guide/latest/reference/error-codes.html
OS/Location:
Explanation:
0x20010004#
Git LFS installation
Error Message: Git LFS installation failed during AI Workbench setup. Git LFS is required for managing large data and model files in your projects.
To fix, you must manually install Git LFS using the following steps:
Ensure you have a stable internet connection.
Try running the installation again.
If the problem persists, install Git LFS manually:
On macOS: Run the following command:
brew install git-lfs
On Ubuntu: Run the following command:
sudo apt-get install git-lfs
After manual installation, run the following command to configure it globally:
git lfs install
Learn more: https://docs.nvidia.com/ai-workbench/user-guide/latest/reference/error-codes.html
OS/Location:
Explanation:
0x20010005#
Service already running prior to install
Error Message: The AI Workbench service is already running. Exit AI Workbench Desktop or deactivate and shutdown the local context.
OS/Location:
Explanation: