Hyper-V
This guide explains how to install CUBE OS on Microsoft Hyper-V running on Windows.
Special thanks to our community contributor @Jordanwise for creating and sharing this helpful tutorial video:
1. Preparation
Download the CUBE OS image
Visit this repo to download the latest .vmdk image. Please extract the image after downloading.
Install Hyper-V
Windows 10 / 11 Pro, Enterprise, or Education (Hyper-V required)
Hyper-V enabled on your system: Before using Hyper-V, make sure it is enabled in Windows. Open Control Panel → Programs → Turn Windows features on or off,
enable Hyper-V (including Hyper-V Management Tools and Hyper-V Platform), Virtual Machine Platform, Windows Hypervisor Platform, then click OK and restart your computer.
Zigbee Adapter (Optional)
If you need to add USB Zigbee devices, please note that Hyper-V does not support native USB passthrough for hardware devices such as Zigbee dongles. If USB access is required, consider using a USB-over-IP solution or a network-based Zigbee coordinator instead.
2. Convert the CUBE OS Image to VHDX
Before creating the virtual machine, convert the CUBE OS disk image to a Hyper-V VHDX compatible format.
Download and install a VM image conversion tool, such as VM Image Converter (recommended on Windows)
Launch the converter and select:
Source format: VMDK
Target format: VHDX
Complete the conversion and note the location of the generated .vhdx file.
3. Create the Virtual Machine
Launch Hyper-V Manager.
Click Quick Create → Select
Local installation source.
Select Change installation source, select the converted CUBE OS .vhdx file and disable Windows Secure Boot.
Enter a name for the VM (for example, CUBE OS), and then Create Virtual Machine.
4. Configure Virtual Machine Settings
Click Settings for the newly created virtual machine.
Assign System Resources:
Minimum: 4096 MB (4 GB)
Disable Dynamic Memory (recommended).
Processor: 2 virtual processors
Click Apply and OK to Save the settings.
5. Boot CUBE OS
Click Connect and Start the created virtual machine.
Wait a few moments for CUBE OS to initialize. Monitor the boot screen until the boot is complete.
Once completed, you will see the CUBE OS' IP displayed on the screen. Use this IP address or cube.local to access the CUBE OS Web management page.
Upon successful access, a short ID can be viewed on the settings page. Subsequently, access the CUBE OS Web management page using cube-{short id}.local, which is useful for differentiating multiple CUBE OS instances on the same local network.
Last updated