# Synology NAS

{% embed url="<https://youtu.be/coJYs-3Jnbo?si=idrpiu9LcMBNvHGa>" %}

## 1. Preparation

Please make sure your setup meets the following requirements:

{% stepper %}
{% step %}
**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.
{% endstep %}

{% step %}
Your NAS has an x86\_64 platform

{% hint style="info" %}
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.
{% endhint %}

{% hint style="info" %}
You can refer to this official [document](https://kb.synology.com/en-me/DSM/tutorial/What_kind_of_CPU_does_my_NAS_have) to find the platform information for your Synology devices.
{% endhint %}
{% endstep %}

{% step %}
WAN access to download the virtual machine manager
{% endstep %}

{% step %}
Admin account to your Synology NAS
{% endstep %}

{% step %}
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](https://darkxst.github.io/silabs-firmware-builder/) by developer @darkxst&#x20;

{% hint style="info" %}
For more information on Zigbee configurations and compatibility, please refer to this [guide](/compatibility-check/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

## 2. Installation

{% stepper %}
{% step %}
Visit this [repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) to download the CUBE OS image ending with `.vdi`&#x20;
{% endstep %}

{% step %}
&#x20;Access to Synology dashboard

<img src="/files/1RTYuQvudhisTzTVWAW9" alt="" data-size="original">
{% endstep %}

{% step %}
Install `Virtual Machine Manager` from the Package Center

<img src="/files/7ORmnid9jb48KDf8zNjy" alt="" data-size="original">
{% endstep %}

{% step %}
Launch `Virtual Machine Manager` from the dashboard and switch to the Image page.
{% endstep %}

{% step %}
Enter the Disk Image tab, then click the `Add` button.

<img src="/files/24T1dsmEIGKDMPTrEVUL" alt="" data-size="original">
{% endstep %}

{% step %}
Follow the guide to upload the `.vdi` file you downloaded from the previous [step](#preparation).

<img src="/files/9MBUgmuAU0JwMJ0Ve5pr" alt="" data-size="original">
{% endstep %}

{% step %}
Wrap the steps and wait for it to be fully uploaded.
{% endstep %}

{% step %}
Switch to the `Image` tab and upload the .vdi file to your NAS. Please wait until it completes uploading.

<img src="/files/11ma2IgVo9e3ZaPVYl0x" alt="" data-size="original">
{% endstep %}

{% step %}
Switch to the `Virtual Machine` page and click on the dropdown icon next to the `Create` button and use `Import`.&#x20;

<img src="/files/RurChnUsB9DcMZgMXBm4" alt="" data-size="original">
{% endstep %}

{% step %}
Select the `Import from disk images` option on the wizard.

<img src="/files/BrrSfpc7RCLA7JQbq9yj" alt="" data-size="original">
{% endstep %}

{% step %}
Select the storage where you uploaded the virtual disk file.

<img src="/files/OtQzSaBPRjFPo4Si9CJf" alt="" data-size="original">
{% endstep %}

{% step %}
Set the computational resources CUBE OS needs.

{% hint style="info" %}
**2 vCPUs and 4GB RAM are recommended for a better experience.**
{% endhint %}

<img src="/files/G3uO3bUdoeDHmfqLDi8E" alt="" data-size="original">
{% endstep %}

{% step %}
Choose the virtual disk on the dropdown list.

<img src="/files/tEXfxguVHclgthW1haq5" alt="" data-size="original">
{% endstep %}

{% step %}
⚠️ For `Other Settings`, choose `UEFI` in the `Firmware` option.

![](/files/orEh0Ga9EXng4mCLmw39)
{% endstep %}

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

{% hint style="info" %}
For more information on Zigbee configurations and compatibility, please refer to this [guide](/compatibility-check/zigbee.md).
{% endhint %}

<img src="/files/TaUXlcJhRpfXbv5G3P3p" alt="" data-size="original">
{% endstep %}

{% step %}
Assign management permission to your NAS accounts.
{% endstep %}

{% step %}
Final review of your configuration, check `Power on the virtual machine after creation` and click `Done`

<img src="/files/WmGGZIz3A3OYdCCifZHI" alt="" data-size="original">
{% endstep %}

{% step %}
Wait for a few minutes. Enter [cube.local](http://cube.local) on your browser to access the onboarding page.

You can also access it via IP alternatively.

<img src="/files/WwQRPxwEGGz0euBRTV4F" alt="" data-size="original">

{% hint style="info" %}
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.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cube.ewelink.cc/getting-started/quickstart/nas-devices/synology-nas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
