> 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/macchina-virtuale/virtualbox.md).

# VirtualBox

{% embed url="<https://www.youtube.com/watch?v=ZRNFkle69BI>" %}

### 1. Preparazione:

{% stepper %}
{% step %}
**Scarica il** CUBE OS **immagine**

Visita questo [repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) per scaricare l'ultima  `.vdi` immagine. Si prega di estrarre l'immagine dopo il download.
{% endstep %}

{% step %}
**Installa macchina virtuale**

Scarica e installa un gestore di macchine virtuali, con [VirtualBox](https://www.virtualbox.org/wiki/Downloads) consigliato.

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

> Hai altri gestori di macchine virtuali? I passaggi seguenti possono teoricamente essere usati anche.\
> Non sei pratico di macchine virtuali e possiedi un Raspberry Pi? Puoi scegliere di installare CUBE OS su un [Raspberry Pi](/english-it/per-iniziare/quickstart/raspberry-pi.md). \
> Se nessuna di queste opzioni è praticabile, puoi acquistare un [iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) con CUBE OS integrato dal sito ufficiale SONOFF o da piattaforme come Amazon.
> {% endstep %}

{% step %}
**Adattatore Zigbee (Opzionale)**

Se è necessario aggiungere dispositivi Zigbee, prepara una chiavetta Zigbee. Le chiavette 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. Crea una macchina virtuale:

{% stepper %}
{% step %}
Avvia VirtualBox

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

{% step %}
Seleziona “Nuovo” <img src="/files/6363a1ae4eca798c7216448744b2426ee8b6ef4e" alt="" data-size="line"> o usa la scorciatoia “Ctrl + N”.
{% endstep %}

{% step %}
Nomina la macchina virtuale, seleziona “Linux” come tipo, “Other Linux” come sottotipo e “Other Linux (64 bit)” come versione.

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

{% step %}
In “Hardware”, assegna la dimensione della memoria e il numero di processori per la macchina virtuale. Si consigliano 4GB di memoria e 2 CPU. Poi, abilita EFI.

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

{% hint style="info" %}
Importante: assicurati che EFI sia abilitato; altrimenti CUBE OS non si avvierà.
{% endhint %}
{% endstep %}

{% step %}
In “Hard Disk”, scegli di usare un file di disco rigido virtuale esistente e seleziona il file .vdi estratto da [Passo 1 della Preparazione.](#id-1-preparation)

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

{% step %}
Clicca “Fine” per creare la macchina virtuale.
{% endstep %}
{% endstepper %}

### 3. Configura la macchina virtuale:

{% stepper %}
{% step %}
Seleziona la macchina virtuale creata e clicca il pulsante “Impostazioni” <img src="/files/cd1fbd7ede30471c45ce93f30f67b8ee715e4f6e" alt="" data-size="line"> .

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

{% step %}
Nella scheda “Rete”, configura la connessione di rete come “Scheda con bridge” e seleziona l'adattatore di rete che stai utilizzando.

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

{% step %}
In “Audio”, abilita il suono e scegli l'opzione Default come controller.&#x20;

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

{% step %}
**Opzionale:** Per l'uso della chiavetta Zigbee, inserisci la chiavetta in questo passaggio e seleziona il tipo di controller corretto in “USB”. Nel filtro USB, aggiungi la chiavetta Zigbee necessaria usando il pulsante di aggiunta sul lato.

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

{% step %}
Clicca “OK” per salvare la configurazione.
{% endstep %}
{% endstepper %}

### 4. Avvia CUBE OS

{% stepper %}
{% step %}
Clicca il pulsante "Avvia" <img src="/files/e8f08e9de90eb866160f465931375d6d5f3f648e" alt="" data-size="line">.

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

{% step %}
Monitora lo schermo di avvio finché l'avvio non è completato.

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

{% step %}
Una volta completato, vedrai l'IP di CUBE OS visualizzato sullo schermo. Usa questo indirizzo IP o [cube.local](http://cube.local) per accedere alla pagina di gestione web di CUBE OS.

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

{% step %}
Una volta effettuato l'accesso con successo, un ID breve può essere visualizzato nella pagina delle impostazioni. Successivamente, accedi alla pagina di gestione web di CUBE OS usando `cube-{short id}.local`, il che è utile per differenziare più istanze di CUBE OS sulla stessa rete locale.

<img src="/files/2db40325561d40803c09d060baa250388469ab1b" alt="" data-size="original">
{% 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/macchina-virtuale/virtualbox.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.