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

Download the installer

Go to the CUBE OS release page and download One-click Installer for 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.