# VirtualBox

{% embed url="<https://www.youtube.com/watch?v=ZRNFkle69BI>" %}

### 1. Vorbereitung:

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

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

{% step %}
**Virtuelle Maschine installieren**

Laden Sie einen virtuellen Maschinenmanager herunter und installieren Sie ihn, wobei [VirtualBox](https://www.virtualbox.org/wiki/Downloads) empfohlen wird.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FaRb8fgybrqGWHbtYS7YU%2FScreenshot%202024-11-15%20133236.png?alt=media&#x26;token=54f2c0f8-d8f6-4ecb-a3f9-400521078928" alt="" data-size="original">
{% endstep %}

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

Wenn Sie Zigbee-Geräte hinzufügen müssen, bereiten Sie einen Zigbee-Dongle vor. Getestete Zigbee-Dongles sind unter anderem:
{% endstep %}
{% endstepper %}

### 2. Erstellen einer virtuellen Maschine:

{% stepper %}
{% step %}
Starten Sie VirtualBox

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZGI9rJk8IUxEdgk3npBQ%2FScreenshot%202024-11-15%20175848.png?alt=media&#x26;token=1966adf2-b3d5-42d0-9896-56d5ccebc601" alt="" data-size="original">
{% endstep %}

{% step %}
Wählen Sie „Neu“ <img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FoNVMloCDlR1eHIbFH3zx%2FScreenshot%202024-11-18%20at%2015.03.19.png?alt=media&#x26;token=586123c1-ea41-4a98-9bb7-7d77cf06af8c" alt="" data-size="line"> oder verwenden Sie die Tastenkombination „Strg + N“.&#x20;
{% endstep %}

{% step %}
Benennen Sie die virtuelle Maschine, wählen Sie „Linux“ als Typ, „Sonstiges Linux“ als Untertyp und „Sonstiges Linux (64-Bit)“ als Version.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fbi2Agh2bcH28tGqszTr3%2FScreenshot%202024-11-15%20175947.png?alt=media&#x26;token=12f50209-ea01-4a50-8102-56714e01dc79" alt="" data-size="original">
{% endstep %}

{% step %}
Unter „Hardware“ weisen Sie der virtuellen Maschine Arbeitsspeichergröße und Prozessoranzahl zu. Es werden 4 GB RAM und 2 CPUs empfohlen. Aktivieren Sie dann EFI.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fo92nbBZaaLAmS2rolN9I%2FScreenshot%202024-11-15%20180009.png?alt=media&#x26;token=b25ab9c3-4f48-4a32-b562-2041d0cf5586" alt="" data-size="original">

{% hint style="info" %}
Wichtig: Stellen Sie sicher, dass EFI aktiviert ist; andernfalls wird CUBE OS nicht starten.
{% endhint %}
{% endstep %}

{% step %}
Unter „Festplatte“ wählen Sie die Verwendung einer vorhandenen virtuellen Festplattendatei und wählen die aus [Vorbereitungsschritt 1 extrahierte .vdi-Datei.](#id-1-preparation)

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FAjeZx31FP1Rn7liZNbNZ%2FScreenshot%202024-11-15%20180529.png?alt=media&#x26;token=90a1a7ff-a8ad-4bc8-a089-753736235af1" alt="" data-size="original">
{% endstep %}

{% step %}
Klicken Sie auf „Fertig“, um die virtuelle Maschine zu erstellen.
{% endstep %}
{% endstepper %}

### 3. Konfigurieren der virtuellen Maschine:

{% stepper %}
{% step %}
Wählen Sie die erstellte virtuelle Maschine aus und klicken Sie auf die Schaltfläche „Einstellungen“ <img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FbCq5o9wm5cZdaXqZgccV%2FScreenshot%202024-11-18%20at%2015.19.16.png?alt=media&#x26;token=7427dab3-d960-4840-87d8-e9cc2c744919" alt="" data-size="line"> .

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F0PSwNRH0LaXpjrpXNFzy%2FScreenshot%202024-11-18%20151129.png?alt=media&#x26;token=a556ce67-64d0-4392-a780-cc757a60c462" alt="" data-size="original">
{% endstep %}

{% step %}
Unter der Registerkarte „Netzwerk“ konfigurieren Sie die Netzwerkverbindung als „Netzwerkbrücke“ und wählen den von Ihnen verwendeten Netzwerkadapter aus.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FOGiUj6l2kVAaaV1PPymk%2FScreenshot%202024-11-15%20180610.png?alt=media&#x26;token=ed4d08ae-a349-47ae-a9d5-0ae426cd4eec" alt="" data-size="original">
{% endstep %}

{% step %}
Unter „Audio“ aktivieren Sie den Ton und wählen die Standardoption als Controller.&#x20;

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FMm18yjdoBCAdBrW9LfPG%2FScreenshot%202024-11-18%20151206.png?alt=media&#x26;token=7c32ee24-cf6c-4d5f-9275-65a0e3665c37" alt="" data-size="original">
{% endstep %}

{% step %}
**Optional:** Für die Verwendung eines Zigbee-Dongles stecken Sie den Zigbee-Dongle in diesem Schritt ein und wählen unter „USB“ den richtigen Controllertyp aus. Fügen Sie im USB-Filter den erforderlichen Zigbee-Dongle mit der Hinzufügen-Schaltfläche an der Seite hinzu.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fc9DMGFIHx7v78szyPBrI%2FScreenshot%202024-11-18%20151754.png?alt=media&#x26;token=f785e096-8cf4-40c4-aa9d-d509c952c616" alt="" data-size="original">
{% endstep %}

{% step %}
Klicken Sie auf „OK“, um die Konfiguration zu speichern.
{% endstep %}
{% endstepper %}

### 4. CUBE OS starten

{% stepper %}
{% step %}
Klicken Sie auf die "Start"-Schaltfläche <img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fclrx0CtpJQxoVq5wOL9j%2FScreenshot%202024-11-18%20at%2015.23.20.png?alt=media&#x26;token=3f60b611-86a8-4e2f-917d-96d776d71c8a" alt="" data-size="line">.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F2t6UwuTSigCxRm4IjKQg%2FScreenshot%202024-11-18%20151129%20copy.png?alt=media&#x26;token=6d622e6c-88e3-4020-bf93-a49989fa6482" alt="" data-size="original">
{% endstep %}

{% step %}
Überwachen Sie den Boot-Bildschirm, bis der Startvorgang abgeschlossen ist.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQwVa8ZvQR1dReJTIzIsb%2FScreenshot%202024-11-18%20152604.png?alt=media&#x26;token=439aa522-de74-4147-84a7-6c02c0fac499" alt="" data-size="original">
{% 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 Webverwaltungsseite von CUBE OS zuzugreifen.

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZbb6mFwPaMSDIRqzexaK%2FScreenshot%202024-11-15%20180746.png?alt=media&#x26;token=8bffc2eb-f774-4ac7-8916-1d04c07e405f" alt="" data-size="original">
{% endstep %}

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

<img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FXJi8azaU8jWkoxymkz8K%2FScreenshot%202024-11-18%20at%2011.33.14.png?alt=media&#x26;token=eb4c5fc2-307f-41d9-b0c7-ccefb6d3ad73" alt="" data-size="original">
{% endstep %}
{% endstepper %}