> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/english-it/per-iniziare/quickstart/dispositivi-nas/ugreen-nas.md).

# UGREEN NAS

## 1. Preparazione

Assicurati che la tua configurazione soddisfi i seguenti requisiti:

{% stepper %}
{% step %}
**6GB di RAM** installati (consigliato) nel tuo NAS UGREEN (4GB per la macchina virtuale che esegue CUBE OS); contatta UGREEN per guide di aggiornamento se la tua unità ha solo 2GB o meno di memoria.
{% endstep %}

{% step %}
Il tuo NAS ha una piattaforma x86\_64

{% hint style="info" %}
Attualmente, solo l'architettura x86\_64 è supportata da questo metodo di installazione.

Per ARM e altre piattaforme, rivolgiti ad altri dispositivi e attendi aggiornamenti futuri.
{% endhint %}
{% endstep %}

{% step %}
Accesso WAN per scaricare il gestore delle macchine virtuali
{% endstep %}

{% step %}
Adattatore Zigbee (Opzionale)

Se devi aggiungere dispositivi Zigbee, prepara una dongle Zigbee. Dongle Zigbee testate includono:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Altri elencati](https://darkxst.github.io/silabs-firmware-builder/) dal sviluppatore @darkxst&#x20;

{% hint style="info" %}
Per ulteriori informazioni sulle configurazioni e la compatibilità Zigbee, consultare questo [guida](/english-it/verifica-compatibilita/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

## 2. Installazione

{% stepper %}
{% step %}
Visita questo [repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) per scaricare l'immagine di CUBE OS che termina con `.vdi`&#x20;
{% endstep %}

{% step %}
&#x20;Accesso alla dashboard UGREEN
{% endstep %}

{% step %}
Installa `Gestore macchine virtuali` da. Avvia `Gestore macchine virtuali` dalla dashboard e passa alla pagina Immagine.

![](/files/9c5a9054fe2bd3ff745ab157c71e9305e92c8867)
{% endstep %}

{% step %}
Clicca **Crea VM**, poi seleziona **Importa macchina virtuale**. Scegli **Importa da file disco**, poi clicca **Avanti**.

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

{% step %}
Se è la prima volta che configuri, seleziona **Carica immagine manualmente**.![](/files/260a65a26516bb8d2a841e06d01b5cdd9ec5ec18)
{% endstep %}

{% step %}
Individua il file CUBE OS scaricato: `.vdi` file:

* Puoi caricarlo dal tuo dispositivo locale, oppure
* Selezionalo dai file esistenti sul tuo NAS.

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

{% step %}
Dopo aver selezionato l'immagine, clicca **Conferma** per caricare e convertire l'immagine.![](/files/786a64dc800aac4f09cb4c2ef1c0c4949544bc0e)
{% endstep %}

{% step %}
Una volta importata, ripeti il **Importa macchina virtuale** processo:

* L'immagine caricata apparirà ora nell'elenco a discesa.
* Selezionala e clicca **Avanti**.

![](/files/2997944cc18cc2ef68474f13f2877d72eeb4814d)
{% endstep %}

{% step %}
Scegli un volume di archiviazione per la macchina virtuale e continua.

![](/files/53b5b74a4a66b5371bbd97d29c5aa872addfa413)
{% endstep %}
{% endstepper %}

## 3. Configurare le impostazioni della macchina virtuale

{% stepper %}
{% step %}
Configurazione di base:

* **Tipo di sistema**: Seleziona **Altro**
* **vCPU**: 2 core (o più se disponibili)
* **Memoria**: Assegna **4GB o più**

![](/files/36c17396984ff00db9e03b3cbcb73b9cb05b9575)
{% endstep %}

{% step %}
Configurazione di rete:

* Seleziona **Modalità Bridge** (Non **usare Host o NAT)** Sotto le opzioni USB, individua e aggiungi la tua dongle USB Zigbee/Thread:

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

{% step %}
Clicca l'

* icona per assegnare la porta USB corretta. **+** icona per assegnare la porta USB corretta.

![](/files/1857eab292f87c3e18735fc0def80d9f56f4d1f8)
{% endstep %}

{% step %}
Imposta **Tipo di Bootstrap** su **UEFI**.

![](/files/46c9f71a3a9d0c5b174e2e656685842c2d3405cf)
{% endstep %}
{% endstepper %}

## 4. Avvio di CUBE OS

{% stepper %}
{% step %}
Torna nell'elenco VM, clicca **Avvia** per accendere la macchina virtuale.![](/files/fb2eb3cb2fce4d7ca7db8ab1ed1b06ef12ffefe8)
{% endstep %}

{% step %}
Attendi qualche minuto. Clicca **Connetti** per visualizzare la console della VM:

* Se appare la schermata di benvenuto di CUBE OS, il sistema è stato avviato correttamente.![](/files/18cb5dcf9d6c8ac6c78db3c465c28d90b4eddef6)
  {% endstep %}

{% step %}
Inserisci [cube.local](http://cube.local) nel tuo browser per accedere alla pagina di onboarding. In alternativa puoi anche accedervi tramite l'IP.

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

{% hint style="info" %}
Dopo l'accesso riuscito, un ID breve può essere visualizzato nella pagina delle impostazioni. Successivamente, accedere alla pagina di gestione Web di CUBE OS utilizzando cube-{short id}.local, utile per differenziare più istanze di CUBE OS sulla stessa rete locale.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/english-it/per-iniziare/quickstart/dispositivi-nas/ugreen-nas.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
