# VirtualBox {% embed url="" %} ### 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. {% endstep %} {% step %} **Adattatore Zigbee (Opzionale)** Se è necessario aggiungere dispositivi Zigbee, prepara una chiavetta Zigbee. Le chiavette Zigbee testate includono: {% endstep %} {% endstepper %} ### 2. Crea una macchina virtuale: {% stepper %} {% step %} Avvia VirtualBox {% endstep %} {% step %} Seleziona “Nuovo” 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. {% 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. {% 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) {% 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” . {% endstep %} {% step %} Nella scheda “Rete”, configura la connessione di rete come “Scheda con bridge” e seleziona l'adattatore di rete che stai utilizzando. {% endstep %} {% step %} In “Audio”, abilita il suono e scegli l'opzione Default come controller. {% 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. {% endstep %} {% step %} Clicca “OK” per salvare la configurazione. {% endstep %} {% endstepper %} ### 4. Avvia CUBE OS {% stepper %} {% step %} Clicca il pulsante "Avvia" . {% endstep %} {% step %} Monitora lo schermo di avvio finché l'avvio non è completato. {% 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. {% 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. {% 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/english-it/primi-passi/quickstart/macchina-virtuale/virtualbox.md?ask= ``` 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.