Synology NAS

1. Preparation

Please make sure your setup meets the following requirements:

1

6GB RAM installed (recommended) in your Synology NAS (4GB for the virtual machine running CUBE OS); Please contact Synology 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.

You can refer to this official document to find the platform information for your Synology devices.

3

WAN access to download the virtual machine manager

4

Admin account to your Synology NAS

5

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 Synology dashboard

3

Install Virtual Machine Manager from the Package Center

4

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

5

Enter the Disk Image tab, then click the Add button.

6

Follow the guide to upload the .vdi file you downloaded from the previous step.

7

Wrap the steps and wait for it to be fully uploaded.

8

Switch to the Image tab and upload the .vdi file to your NAS. Please wait until it completes uploading.

9

Switch to the Virtual Machine page and click on the dropdown icon next to the Create button and use Import.

10

Select the Import from disk images option on the wizard.

11

Select the storage where you uploaded the virtual disk file.

12

Set the computational resources CUBE OS needs.

2 vCPUs and 4GB RAM are recommended for a better experience.

13

Choose the virtual disk on the dropdown list.

14

⚠️ For Other Settings, choose UEFI in the Firmware option.

15

Optional: Plug in your Zigbee dongle to your NAS, and pass through the device to the virtual machine on this page.

For more information on Zigbee configurations and compatibility, please refer to this guide.

16

Assign management permission to your NAS accounts.

17

Final review of your configuration, check Power on the virtual machine after creation and click Done

18

Wait for a few minutes. 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.