Is this page helpful?

Windows Full Local Install Reference#

Overview#

This reference provides guidance on configuring system settings that AI Workbench requires for the full local install.

Use the specific sections to resolve any issues.

Cross reference steps with the Windows documentation and your manufacturer’s specific instructions.

There are links to relevant documentation.

Configure User Account Controls#

Microsoft User Account Controls (UAC) must be set properly.

UAC sets the controls if and how you are alerted when applications request elevated privileges.

AI Workbench needs elevated privileges at a few points during the full local install, so you need to set UAC so that you can see and authorize those requests.

Set UAC to “Notify me only when apps try to make changes to my computer (default)”

  1. Go to Control Panel > User Accounts > User Accounts > Change User Account Control settings

  2. Set slider to Notify me only when apps try to make changes to my computer (default)

  3. Click OK

Enable Virtualization#

AI Workbench requires Windows Subsystem for Linux (WSL2), which requires virtualization.

Virtualization is usually enabled by default, but there are instances when it is not. AI Workbench will check if it is enabled during the full local install.

If virtualization isn’t enabled, you must enable it manually.

AI Workbench will alert you to this but it does NOT enable virtualization for you. You must do this manually in your system’s BIOS menu.

To get to the BIOS menu, restart your computer and hit the “BIOS key” while it is rebooting.

This interrupts the startup process and redirects you to the BIOS menu. Generic instructions are:

  1. Find the BIOS key and location of the virtualization settings for your manufacturer.

  2. Restart your computer and hit the BIOS key as your computer restarts.

  3. Go to the virtualization setting in the menu.

  4. Enable virtualization.

  5. Exit the BIOS to restart your computer.

BIOS key and virtualization settings are manufacturer dependent.

These are instructions for common manufacturers.

Windows Subsystem for Linux (WSL2) Enablement#

As long as virtualization is enabled, AI Workbench will handle this for you.

WSL is typically enabled, but in some cases it is not.

If that is the case, AI Workbench can enable it for you but will request authorization to do so through UAC.

NVIDIA GPU Drivers on Windows#

  • If your system has an NVIDIA GPU, you must install the drivers manually

  • Use the NVIDIA App to install and manage your drivers