> 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/german/erste-schritte/quickstart/virtuelle-maschine/hyper-v.md).

# Hyper-V

Diese Anleitung erklärt, wie man CUBE OS auf Microsoft Hyper-V unter Windows installiert.

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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cube.ewelink.cc/german/erste-schritte/quickstart/virtuelle-maschine/hyper-v.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.