> 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/hyper-v.md).

# Hyper-V

Un ringraziamento speciale al nostro contributore della community [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) per aver creato e condiviso questo utile video tutorial:

{% embed url="<https://www.youtube.com/watch?v=StVw-60Piuk>" %}

### 1. Preparazione <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

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

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

{% step %}
**Installa Hyper-V**

Windows 10 / 11 Pro, Enterprise o Education (richiesto Hyper-V)

Hyper-V abilitato sul tuo sistema: prima di usare Hyper-V, assicurati che sia abilitato in Windows. Apri **Pannello di controllo → Programmi → Attiva o disattiva funzionalità Windows**,&#x20;

<div align="left"><figure><img src="/files/9c4a4fa540f89fbb846daaf0ab48512ea814e105" alt="" width="310"><figcaption></figcaption></figure></div>

abilita **Hyper-V** (inclusi *Strumenti di gestione Hyper-V* e *Piattaforma Hyper-V*), **Piattaforma Macchina Virtuale**, **Piattaforma Hypervisor di Windows**, quindi fai clic su **OK** e riavvia il computer.

<div align="left"><figure><img src="/files/3e8a860fe6f10e7bb6cf321f60369b38b8d2af87" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

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

Se hai bisogno di aggiungere dispositivi Zigbee USB, nota che Hyper-V non supporta il passthrough USB nativo per dispositivi hardware come dongle Zigbee. Se è necessario l'accesso USB, considera l'uso di una **soluzione USB-over-IP** o un **coordinatore Zigbee basato su rete** invece.
{% endstep %}
{% endstepper %}

### 2. Convertire l'immagine CUBE OS in VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Prima di creare la macchina virtuale, converti l'immagine del disco di CUBE OS in un formato Hyper-V **VHDX** compatibile.

{% stepper %}
{% step %}
Scarica e installa uno strumento di conversione immagine VM, come **VM Image Converter** (consigliato su Windows)&#x20;

<div align="left"><figure><img src="/files/a1d4c4b0d6b54fc5d61b3b947393a05940c55fc5" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Avvia il convertitore e seleziona:

* Formato sorgente: **VMDK**
* Formato di destinazione: **VHDX**

<div align="left"><figure><img src="/files/cc5e3f335fe1aab74f74c40f13367c74db5c2a6a" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Completa la conversione e annota la posizione del `.vhdx` file generato.

<div align="left"><figure><img src="/files/e471c8aedf01c98bb0390463cb3175de0b6974df" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. Crea la macchina virtuale <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Avvia **Hyper-V Manager**.

<div align="left"><figure><img src="/files/e72bcbbb843329836bc0ec1d510a7ef89ccf4cd4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Fai clic su **Creazione rapida** → Seleziona![](/files/342a23c7cd02f8fe4f6dde3f5dfd372946a85ffc)**Sorgente di installazione locale**.

<div align="left"><figure><img src="/files/6028bc360c2c73aa7ac6a421750a7040f2d6460f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Seleziona **Cambia sorgente di installazione**, seleziona il **CUBE OS `.vhdx`** file convertito e disabilita **Windows Secure Boot**.

<div align="left"><figure><img src="/files/c15c1708e0764ae917b8fdeaf280676626c65fa1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Inserisci un nome per la VM (per esempio, `CUBE OS`), e poi **Crea macchina virtuale**.
{% endstep %}
{% endstepper %}

### 4. Configura le impostazioni della macchina virtuale <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Fai clic su **Impostazioni** per la macchina virtuale appena creata.

<div align="left"><figure><img src="/files/d8c0c0beb2a0ab99a433f183fa59f619521fe5d5" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Assegna risorse di sistema:

* Minimo: **4096 MB (4 GB)**
* Disabilita la Memoria Dinamica (consigliato).
* **Processore**: 2 processori virtuali

<div align="left"><figure><img src="/files/c591b9f13e48b9d728ff54f760bedcbf1eb04181" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Fai clic su **Applica** e **OK** per salvare le impostazioni.
{% endstep %}
{% endstepper %}

### 5. Avvia CUBE OS

{% stepper %}
{% step %}
Fai clic su **Connetti** e **Avvia** la macchina virtuale creata.

<div align="left"><figure><img src="/files/d9d44201d0bc979ad854bd0d70b69688f5baa7a1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Attendi qualche istante affinché CUBE OS si inizializzi. Monitora lo schermo di avvio fino al completamento del boot.

<div align="left"><figure><img src="/files/c17493c64506738c6c6676e59df0be9238407e33" alt="" width="375"><figcaption></figcaption></figure></div>
{% 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.

<div align="left"><figure><img src="/files/e9e17a617b44fc531cc6f88dad4fc0e8ddd352b8" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="/files/c5cff862ddfef3b3e4e3e103fbb3425e70dd4aa6" alt="" width="375"><figcaption></figcaption></figure></div>
{% 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/hyper-v.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.