# 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 %}


---

# Agent Instructions: 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:

```
GET https://cube.ewelink.cc/german/erste-schritte/quickstart/virtual-machine/virtualbox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
