Intelligent Desktop Virtualization (IDV) for Education

ID Date Version Classification
824808 06/26/2025 1.3.13-3.1 Public
Document Table of Contents
Document Table of Contents
Legal Revision History Introduction Network Setup and Hardware System Requirement IDV Server Setup OS Image Creation Provisioning Resources
Legal
Revision History
Introduction
Introduction Auto-Provisioning Terminology Reference Documents and Software Packages Other References
Auto-Provisioning
Terminology
Reference Documents and Software Packages
Other References
Network Setup and Hardware System Requirement
Network Setup Hardware System Requirement
Network Setup
Hardware System Requirement
IDV Server Setup
IDV Server Setup Setting Up IDV and Build Server (Ubuntu) Setting Up IDV Server (Ubuntu) Setting Up IDV Server (Windows)
Setting Up IDV and Build Server (Ubuntu)
Setting Up IDV and Build Server (Ubuntu) Setting Up IDV Server Build Server Kernel Build and Installation for ADL Setup
Setting Up IDV Server
Build Server Kernel Build and Installation for ADL Setup
Setting Up IDV Server (Ubuntu)
Setting Up IDV Server (Windows)
Setting Up IDV Server (Windows) Prerequisites Setup
Prerequisites
Setup
OS Image Creation
OS Image Creation Create ISO Image for IDV Server (Ubuntu) Create ISO Image for IDV Server (Windows) Create ISO Image for IDV Host Create ISO Image for IDV Guest (Ubuntu) Create ISO Image for IDV Guest (Windows)
Create ISO Image for IDV Server (Ubuntu)
Create ISO Image for IDV Server (Windows)
Prerequisites Prepare Windows IDV Server ISO Image
Prerequisites
Prepare Windows IDV Server ISO Image
Prepare Windows IDV Server ISO Image Integrate IDV Package into Windows IDV Server ISO Enable Unattended Install Complete and Save Windows ISO Script to run after having Internet access
Integrate IDV Package into Windows IDV Server ISO
Enable Unattended Install
Complete and Save Windows ISO
Script to run after having Internet access
Create ISO Image for IDV Host
Create ISO Image for IDV Guest (Ubuntu)
On ADL IDV Build Server On MTL IDV Build Server
On ADL IDV Build Server
On MTL IDV Build Server
Create ISO Image for IDV Guest (Windows)
Create ISO Image for IDV Guest (Windows) Create Windows Virtual Machine using Virtual Machine Manager Running on Ubuntu OS Create Customized Windows ISO Image for the IDV Guest using NTLite Create IDV Guest (Windows) Manually without NTLite Create Customized Windows ISO Image for the IDV Guest on MTL
Create Windows Virtual Machine using Virtual Machine Manager Running on Ubuntu OS
Create Customized Windows ISO Image for the IDV Guest using NTLite
Prerequisites Prepare Windows IDV Guest ISO Image Integrate Windows 10 Cumulative Update Integrate Graphics GFX Driver, SR-IOV Zero Copy Driver, Virtio Driver, Veyon Disable Windows Fast Startup and Windows Update Enable Unattended Install Complete and Save Windows ISO Install Windows VM Image
Prerequisites
Prepare Windows IDV Guest ISO Image
Integrate Windows 10 Cumulative Update
Integrate Graphics GFX Driver, SR-IOV Zero Copy Driver, Virtio Driver, Veyon
Disable Windows Fast Startup and Windows Update
Enable Unattended Install
Complete and Save Windows ISO
Install Windows VM Image
Create IDV Guest (Windows) Manually without NTLite
Create Customized Windows ISO Image for the IDV Guest on MTL
Prerequisites Create NoPrompt Windows* Installation ISO Image Create Windows* Guest VM Image
Prerequisites
Create NoPrompt Windows* Installation ISO Image
Create Windows* Guest VM Image
Provisioning
Auto-Provisioning
Auto-Provisioning
Auto-Provisioning Stage 1: Provisioning Stage Stage 2: Deployment Stage
Stage 1: Provisioning Stage
Stage 1: Provisioning Stage Configure IDV Server as Provision Server for IDV Host Mass Provision IDV Host Configure IDV Server as Provision Server for IDV Server Mass Provision IDV Server
Configure IDV Server as Provision Server for IDV Host
Mass Provision IDV Host
Configure IDV Server as Provision Server for IDV Server
Mass Provision IDV Server
Stage 2: Deployment Stage
Resources
PXE Boot Setup in BIOS Configure IDV Host Configure IDV Host with GUI Environment Variable Configuration Standalone IDV Host Configuration Update IDV Host Software Package IDV Hosts Network Migration or Network Subnet Changed Switch IDV Server Mode in IDV Host Veyon User Guide i3WM User Guide Power and Wi-Fi Management Disable Graphics Driver Updates Enable Wake-On-LAN – (Intel NUC) MTL Wi-Fi Setup for IDV Server / IDV Host Other Important Configurations for Windows VM Troubleshooting
PXE Boot Setup in BIOS
Configure IDV Host
Configure IDV Host with GUI
Environment Variable Configuration
Standalone IDV Host Configuration
Update IDV Host Software Package
IDV Hosts Network Migration or Network Subnet Changed
Switch IDV Server Mode in IDV Host
Veyon User Guide
Veyon User Guide Veyon Master IDV Guest (Ubuntu) IDV Guest (Windows)
Veyon Master
IDV Guest (Ubuntu)
IDV Guest (Windows)
i3WM User Guide
i3WM User Guide VMs Launching Power-Wi-Fi Menu Admin Mode Summary
VMs Launching
Power-Wi-Fi Menu
Admin Mode
Admin Mode Moving around Container layout Fullscreen Terminal Opening other applications – Program Launcher Changing wallpaper Closing windows Reload, restart and exit i3WM
Moving around
Container layout
Fullscreen
Terminal
Opening other applications – Program Launcher
Changing wallpaper
Closing windows
Reload, restart and exit i3WM
Summary
Power and Wi-Fi Management
Power and Wi-Fi Management Power Management Wi-Fi Management
Power Management
Wi-Fi Management
Turning on/off Wi-Fi interface Connecting to a Wi-Fi network
Turning on/off Wi-Fi interface
Connecting to a Wi-Fi network
Disable Graphics Driver Updates
Disable Graphics Driver Updates Identify the Graphics Hardware ID Enable Group Policy to Disable Graphics Driver Update Resume Windows Update
Identify the Graphics Hardware ID
Enable Group Policy to Disable Graphics Driver Update
Resume Windows Update
Enable Wake-On-LAN – (Intel NUC)
MTL Wi-Fi Setup for IDV Server / IDV Host
Other Important Configurations for Windows VM
Troubleshooting
IDV Server Installation Different Language Chosen for idvserver Failed to Mount NFS Veyon Configurator Not Found PXE Boot is Not Working Failed to run start_windows.sh on Could not set up host forwarding rule “tcp::3389-:3389” Unable to launch Windows Installation when run install_windows.sh script Failed to auto-launch VM after IDV Host Provisioning Image Corruption on Minecraft Education Application Cannot Open Camera App on Multiple VM at the Same Time Failed to Run setup_vm_gui_config.windows.bat in Windows IDV Server Veyon Login Feature – Unable to Log In
IDV Server Installation
Different Language Chosen for idvserver
Failed to Mount NFS
Veyon Configurator Not Found
PXE Boot is Not Working
Failed to run start_windows.sh on Could not set up host forwarding rule “tcp::3389-:3389”
Unable to launch Windows Installation when run install_windows.sh script
Failed to auto-launch VM after IDV Host Provisioning
Image Corruption on Minecraft Education Application
Cannot Open Camera App on Multiple VM at the Same Time
Failed to Run setup_vm_gui_config.windows.bat in Windows IDV Server
Veyon Login Feature – Unable to Log In

Prerequisites

  1. A machine running on Windows OS or refer to Create Windows Virtual Machine using Virtual Machine Manager Running on Ubuntu OS
  2. Download and install NTLite on Windows from the official site.
    3. Note:NTLite is free to download and use in its basic version for personal and trial purposes only. Read the license agreement for details. This document is based on NTLite v2024.5.9946
  3. For Windows 11, download Windows 11 IoT Enterprise version 22H2 iso image. (While other versions of Windows 11 are not currently being validated, they may still work as well.)
  4. Download Veyon 4.8.3 from the official GitHub release.
  5. Get the latest package idv-v1.3.13.zip.
  6. Download Python 3.12.4 at Windows installer (64-bit)
  7. Get Rufus from the official site.
  8. Unzip the idv package, and copy the files below into one folder:
    1. At /scripts/idv-client/
      • idv-vm.conf
    2. At /scripts/windows_​setup/
      • build_​configurator.bat
      • enable-smb.idvserver.ps1
      • veyon.idvserver.windows.py
      • server_​api.py
      • server-api.idvserver.xml
      • setup_​vm_​gui_​config.windows.bat
      • setup.idvserver.windows.bat. If a proxy is required, replace the proxy in this file with the correct proxy before copying this file

      3. image15.png

      Notes: Only changes on these two lines are required

    3. At /gui folder, zip idv-vm-configurator folder as below:
      • idv-vm-configurator.zip
Prepare Windows IDV Server ISO Image