Windows
This guide shows you how to install CUBE OS on Windows with the One-click Installer. The installer sets up VirtualBox, creates the virtual machine, and starts CUBE OS for you.
1. Preparation
Check your Windows PC
Make sure your PC meets these requirements:
OS: Windows 10 or Windows 11, 64-bit
CPU: 2 cores or more
Memory: 4 GB RAM or more
Network: Stable internet and LAN access
Permissions: Administrator access on Windows
Zigbee Adapter (Optional)
If you need to add Zigbee devices, prepare a Zigbee Dongle. Tested Zigbee Dongles include:
SONOFF ZBDongle-MAX SONOFF ZBDongle-PMG24 SONOFF ZBDongle-LMG21 SONOFF ZBDongle-E SONOFF ZBDongle-P Others listed by developer @darkxst
For more information on Zigbee configurations and compatibility, please refer to this guide.
2. Install CUBE OS with the One-click Installer
Run the installer as administrator
Find the installer file in Downloads or your chosen folder. Right-click it and select Run as administrator.

Let the installer check VirtualBox
The installer checks whether VirtualBox is available on your PC. If VirtualBox is not installed, follow the on-screen steps to install it first.

Set virtual machine resources
Choose the virtual machine name, memory, and CPU cores. Recommended settings:
Memory: 2048 MB or more
CPU: 2 cores or more

Select a bridged network adapter
Choose an active network adapter on your PC. Use a bridged adapter so CUBE OS can join your local network.

Optional: Configure USB passthrough
If you use a Zigbee dongle, select the USB device from the list. If you do not need Zigbee now, skip this step.

Start the installation
The installer extracts the required files and creates the CUBE OS virtual machine automatically. Wait until the process finishes, then click Finish.


3. Boot and access CUBE OS
Wait for CUBE OS to start
After installation, the virtual machine starts automatically in VirtualBox. When boot completes, the console shows the CUBE OS IP address.

Open the CUBE OS web console
Open a browser on the same network and visit one of these addresses:
http://<CUBE_OS_IP>/

Use the short local address later
After setup, you can find the short ID on the settings page. You can then use cube-{short-id}.local to identify this CUBE OS instance on your LAN.

Last updated
