UGREEN NAS

1. Preparation

Please make sure your setup meets the following requirements:

1

6GB RAM installed (recommended) in your UGREEN NAS (4GB for the virtual machine running CUBE OS); Please contact UGREEN for upgrading guides if your unit only has 2GB or less memory.

2

Your NAS has an x86_64 platform

Currently, only x86_64 architecture is supported by this installation method.

For ARM and other platforms, please turn to other devices and wait for future updates.

3

WAN access to download the virtual machine manager

4

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. Installation

1

Visit this repo to download the CUBE OS image ending with .vdi

2

Access to UGREEN dashboard

3

Install Virtual Machine Manager from. Launch Virtual Machine Manager from the dashboard and switch to the Image page.

4

Click Create VM, then select Import Virtual Machine. Choose Import from Disk File, then click Next.

5

If this is your first time setting up, select Upload image manually.

6

Locate the downloaded CUBE OS .vdi file:

• You can upload it from your local device, or

• Select it from existing files on your NAS.

7

After selecting the image, click Confirm to upload and convert the image.

8

Once imported, repeat the Import Virtual Machine process:

• The uploaded image will now appear in the dropdown list.

• Select it and click Next.

9

Choose a storage volume for the virtual machine and continue.

3. Configure Virtual Machine Settings

1

Basic Configuration:

• System type: Select Other

• vCPUs: 2 cores (or more if available)

• Memory: Allocate 4GB or more

2

Network Configuration:

• Select Bridge mode (Do not use Host or NAT)

3

Under USB options, locate and add your Zigbee/Thread USB dongle:

• Click the + icon to assign the correct USB port.

4

Set Bootstrap Type to UEFI.

4. Booting CUBE OS

1

Back in the VM list, click Start to power on the virtual machine.

2

Wait for a few minutes. Click Connect to view the VM console:

• If the CUBE OS welcome screen appears, the system has started successfully.

3

Enter cube.local on your browser to access the onboarding page. You can also access it via IP alternatively.

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.