# Hyper-V

Besonderer Dank an unseren Community-Beitragenden [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) für das Erstellen und Teilen dieses hilfreichen Tutorial-Videos:

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

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

{% stepper %}
{% step %}
**Laden Sie das** CUBE OS **Image**

Besuchen Sie dieses [Repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) um das neueste `.vmdk` Image herunterzuladen. Bitte extrahieren Sie das Image nach dem Herunterladen.
{% endstep %}

{% step %}
**Installieren Sie Hyper-V**

Windows 10 / 11 Pro, Enterprise oder Education (Hyper-V erforderlich)

Hyper-V auf Ihrem System aktiviert: Bevor Sie Hyper-V verwenden, stellen Sie sicher, dass es in Windows aktiviert ist. Öffnen Sie **Systemsteuerung → Programme → Windows-Features ein- oder ausschalten**,&#x20;

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FWDcT9mnUIFijGtyKD6cm%2Fimage.png?alt=media&#x26;token=e436eae3-61cb-4e08-a3e0-612f0b37960b" alt="" width="310"><figcaption></figcaption></figure></div>

aktivieren **Hyper-V** (einschließlich *Hyper-V-Verwaltungstools* und *Hyper-V-Plattform*), **Virtual Machine Platform**, **Windows Hypervisor Platform**, dann klicken Sie **OK** und starten Sie Ihren Computer neu.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FULGXxO2KkrnniwM6CQvr%2Fimage.png?alt=media&#x26;token=0ce61757-dbf8-4ba5-9ab9-b8d635250028" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Zigbee-Adapter (optional)**

Wenn Sie USB-Zigbee-Geräte hinzufügen müssen, beachten Sie bitte, dass Hyper-V keine native USB-Durchleitung für Hardwaregeräte wie Zigbee-Dongles unterstützt. Falls USB-Zugriff erforderlich ist, sollten Sie eine **USB-over-IP-Lösung** oder einen **netzwerkbasierten Zigbee-Koordinator** stattdessen in Betracht ziehen.
{% endstep %}
{% endstepper %}

### 2. Konvertieren des CUBE OS-Images in VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Bevor Sie die virtuelle Maschine erstellen, konvertieren Sie das CUBE OS-Festplattenimage in ein Hyper-V- **VHDX** kompatibles Format.

{% stepper %}
{% step %}
Laden Sie ein Tool zur VM-Image-Konvertierung herunter und installieren Sie es, z. B. **VM Image Converter** (empfohlen für Windows)&#x20;

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FClQstydrldjmcLuKnY6J%2Fimage.png?alt=media&#x26;token=82d68ed0-cbdb-40ab-a655-43355f62d0d9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Starten Sie den Konverter und wählen Sie:

* Quellformat: **VMDK**
* Zielformat: **VHDX**

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F7iCfbFg9ACqHTf4qWAMQ%2Fimage.png?alt=media&#x26;token=9cdf81ab-e4b2-4cd9-a75f-f6a265b57973" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Schließen Sie die Konvertierung ab und merken Sie sich den Speicherort der erzeugten `.vhdx` Datei.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQKS70hxaW1oTz6RCwmic%2Fimage.png?alt=media&#x26;token=eeffdb9e-2408-46aa-926e-a1be47ad6bb2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. Erstellen der virtuellen Maschine <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Starten Sie **Hyper-V-Manager**.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FKLGnYhpnW4TUgAiSVzta%2Fimage.png?alt=media&#x26;token=27dfe2ee-cefa-473b-a5eb-397ecf905871" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Klicken Sie **Schnell erstellen** → Wählen![](https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8yCryNG9EQ2ZML71mllN%2Fimage.png?alt=media\&token=d005ecdb-686a-4373-bf54-14a94a273d1f)**Lokale Installationsquelle**.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Ff5qgA3WXeEw1KlNAQehR%2Fimage.png?alt=media&#x26;token=6f4f67dc-11c5-4f87-b794-26cb34e01b97" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Wählen Sie **Installationsquelle ändern**, wählen Sie die konvertierte **CUBE OS `.vhdx`** Datei und deaktivieren Sie **Windows Secure Boot**.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FLekBkkamd2Hydx4xsEYv%2Fimage.png?alt=media&#x26;token=0ed27f1f-3756-4fdf-8dab-d3491a5ca132" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Geben Sie einen Namen für die VM ein (zum Beispiel, `CUBE OS`), und dann **Virtuelle Maschine erstellen**.
{% endstep %}
{% endstepper %}

### 4. Konfigurieren der Einstellungen der virtuellen Maschine <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Klicken Sie **Einstellungen** für die neu erstellte virtuelle Maschine.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FlyxZ9KvMx4bpzL0cQEes%2Fimage.png?alt=media&#x26;token=e6cbd439-042d-4cef-821a-7d86bf1558bc" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Systemressourcen zuweisen:

* Minimum: **4096 MB (4 GB)**
* Deaktivieren Sie dynamischen Arbeitsspeicher (empfohlen).
* **Prozessor**: 2 virtuelle Prozessoren

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZdfwbJkXE2NyfMI6Wcsb%2Fimage.png?alt=media&#x26;token=c941758a-e5b1-44ad-91e9-03f757a6434f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Klicken Sie **Übernehmen** und **OK** um die Einstellungen zu speichern.
{% endstep %}
{% endstepper %}

### 5. CUBE OS starten

{% stepper %}
{% step %}
Klicken Sie **Verbinden** und **Starten** Sie die erstellte virtuelle Maschine.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FafxqxaM2WCQFAmiBM1PL%2Fimage.png?alt=media&#x26;token=78525be1-b531-4151-af31-c4a3952da45e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Warten Sie einen Moment, bis CUBE OS initialisiert ist. Überwachen Sie den Boot-Bildschirm, bis der Startvorgang abgeschlossen ist.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FmsvbU2r30xq0WmtqjTLP%2Fimage.png?alt=media&#x26;token=bbe50140-3a33-4d18-92cf-43df705b49b1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Nach Abschluss wird die IP von CUBE OS auf dem Bildschirm angezeigt. Verwenden Sie diese IP-Adresse oder [cube.local](http://cube.local/) um auf die CUBE OS-Webverwaltungsseite zuzugreifen.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Nach erfolgreichem Zugriff kann auf der Einstellungsseite eine kurze ID angezeigt werden. Greifen Sie anschließend mit `cube-{short id}.local`auf die CUBE OS-Webverwaltungsseite zu, was nützlich ist, um mehrere CUBE OS-Instanzen im selben lokalen Netzwerk zu unterscheiden.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}