Hyper‑V

Diese Anleitung erklärt, wie man CUBE OS auf Microsoft Hyper‑V installiert, das unter Windows läuft.

Besonderer Dank an unseren Community-Beitragenden @Jordanwise für das Erstellen und Teilen dieses hilfreichen Tutorial-Videos:

1. Vorbereitung

1

Laden Sie das CUBE OS Image

Besuchen Sie dieses Repo um das neueste .vmdk Image herunterzuladen. Bitte extrahieren Sie das Image nach dem Herunterladen.

2

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,

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.

3

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.

2. Konvertieren des CUBE OS-Images in VHDX

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

1

Laden Sie ein Tool zur VM-Image-Konvertierung herunter und installieren Sie es, z. B. VM Image Converter (empfohlen für Windows)

2

Starten Sie den Konverter und wählen Sie:

• Quellformat: VMDK

• Zielformat: VHDX

3

Schließen Sie die Konvertierung ab und merken Sie sich den Speicherort der erzeugten .vhdx Datei.

3. Erstellen der virtuellen Maschine

1

Starten Sie Hyper-V-Manager.

2

Klicken Sie Schnell erstellen → WählenLokale Installationsquelle.

3

Wählen Sie Installationsquelle ändern, wählen Sie die konvertierte CUBE OS .vhdx Datei und deaktivieren Sie Windows Secure Boot.

4

Geben Sie einen Namen für die VM ein (zum Beispiel, CUBE OS), und dann Virtuelle Maschine erstellen.

4. Konfigurieren der Einstellungen der virtuellen Maschine

1

Klicken Sie Einstellungen für die neu erstellte virtuelle Maschine.

2

Systemressourcen zuweisen:

• Minimum: 4096 MB (4 GB)

• Deaktivieren Sie dynamischen Arbeitsspeicher (empfohlen).

• Prozessor: 2 virtuelle Prozessoren

3

Klicken Sie Übernehmen und OK um die Einstellungen zu speichern.

5. CUBE OS starten

1

Klicken Sie Verbinden und Starten Sie die erstellte virtuelle Maschine.

2

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

3

Nach Abschluss wird die IP von CUBE OS auf dem Bildschirm angezeigt. Verwenden Sie diese IP-Adresse oder cube.local um auf die CUBE OS-Webverwaltungsseite zuzugreifen.

4

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