> 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/installation-mit-einem-klick/windows.md).

# Windows

Diese Anleitung zeigt Ihnen, wie Sie CUBE OS unter Windows mit dem One-Click-Installer installieren. Der Installer richtet VirtualBox ein, erstellt die virtuelle Maschine und startet CUBE OS für Sie.

### 1. Vorbereitung

{% stepper %}
{% step %}
**Überprüfen Sie Ihren Windows-PC**

Stellen Sie sicher, dass Ihr PC diese Anforderungen erfüllt:

* **Betriebssystem**: Windows 10 oder Windows 11, 64-Bit
* **CPU**: 2 Kerne oder mehr
* **Speicher**: 4 GB RAM oder mehr
* **Netzwerk**: Stabiles Internet und LAN-Zugang
* **Berechtigungen**: Administratorzugriff unter Windows
*

{% endstep %}

{% step %}
**Laden Sie den Installer herunter**

Gehen Sie zur [CUBE OS-Release-Seite](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) und laden Sie **den One-Click-Installer für Windows herunter**.

<div align="left"><figure><img src="/files/547221423e9c1de1f8f6b521ab0ad578964498cc" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

Wenn Sie Zigbee-Geräte hinzufügen müssen, bereiten Sie einen Zigbee-Dongle vor. Zu den getesteten Zigbee-Dongles gehören:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Andere aufgeführt](https://darkxst.github.io/silabs-firmware-builder/) vom Entwickler @darkxst&#x20;

{% hint style="info" %}
Für weitere Informationen zu Zigbee-Konfigurationen und Kompatibilität lesen Sie bitte dies [Handbuch](/german/kompatibilitatsprufung/zigbee.md).
{% endhint %}

Bevor Sie den Zigbee-Adapter mit Windows verbinden, installieren Sie den passenden USB-Seriell-Treiber für den Dongle-Chipsatz:

* **CP210x** — [Silicon Labs CP210x USB-to-UART-Bridge-VCP-Treiber](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
* **CH34x** — [WCH CH341/CH34x USB-Seriell-Treiber](https://www.wch-ic.com/downloads/CH341SER_EXE.html)

{% hint style="info" %}
Wenn Windows den Dongle im Installer oder in VirtualBox nicht erkennt, ziehen Sie den Adapter ab, installieren Sie den Treiber und schließen Sie ihn dann erneut an.
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. Installieren Sie CUBE OS mit dem One-Click-Installer

{% stepper %}
{% step %}
**Führen Sie den Installer als Administrator aus**

Suchen Sie die Installationsdatei im Ordner **Downloads** oder in dem von Ihnen gewählten Ordner. Klicken Sie mit der rechten Maustaste darauf und wählen Sie **Als Administrator ausführen**.

<div align="left"><figure><img src="/files/623a04e4ae0fef0135673d4cdd2a222413af4828" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Lassen Sie den Installer VirtualBox prüfen**

Der Installer prüft, ob VirtualBox auf Ihrem PC verfügbar ist. Wenn VirtualBox nicht installiert ist, folgen Sie den Anweisungen auf dem Bildschirm, um es zuerst zu installieren.

<div align="left"><figure><img src="/files/01280bb7579599532ce8730bdb81f7427f6e0cd2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Virtuelle Maschinenressourcen festlegen**

Wählen Sie den Namen der virtuellen Maschine, den Speicher und die CPU-Kerne aus. Empfohlene Einstellungen:

* **Speicher**: 2048 MB oder mehr
* **CPU**: 2 Kerne oder mehr

<div align="left"><figure><img src="/files/b0593bd13d5e5d289b622893a7950df02770ef54" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Wählen Sie einen gebrückten Netzwerkadapter aus**

Wählen Sie einen aktiven Netzwerkadapter auf Ihrem PC aus. Verwenden Sie einen gebrückten Adapter, damit CUBE OS Ihrem lokalen Netzwerk beitreten kann.

<div align="left"><figure><img src="/files/5fe96a112f42539d55682a525d449e8bcbf52638" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Optional: USB-Durchleitung konfigurieren**

Wenn Sie einen Zigbee-Dongle verwenden, wählen Sie das USB-Gerät aus der Liste aus. Wenn Sie Zigbee jetzt nicht benötigen, überspringen Sie diesen Schritt.

<div align="left"><figure><img src="/files/26af02d8fc7c803cf52a9968f5aeb662040986e1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Starten Sie die Installation**

Der Installer entpackt die erforderlichen Dateien und erstellt die virtuelle CUBE-OS-Maschine automatisch. Warten Sie, bis der Vorgang abgeschlossen ist, und klicken Sie dann auf **Fertig**.

<div align="left"><figure><img src="/files/51776821ba52117eb82472b86f8c122131431a99" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/fcc83ef652f7ad530dff9499e8b8c3d6dc50a141" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. CUBE OS starten und aufrufen

{% stepper %}
{% step %}
**Warten Sie, bis CUBE OS startet**

Nach der Installation startet die virtuelle Maschine automatisch in VirtualBox. Wenn der Start abgeschlossen ist, zeigt die Konsole die IP-Adresse von CUBE OS an.

<div align="left"><figure><img src="/files/812abe69780dfb5e4c42f9c3f4cf14da7cad06eb" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Öffnen Sie die CUBE-OS-Webkonsole**

Öffnen Sie einen Browser im selben Netzwerk und rufen Sie eine dieser Adressen auf:

* `http://<CUBE_OS_IP>/`
* <http://cube.local>

<div align="left"><figure><img src="/files/9627630bf980ff87cc780019bfd7ddceedfe814f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Verwenden Sie später die kurze lokale Adresse**

Nach der Einrichtung finden Sie die kurze ID auf der Einstellungsseite. Sie können dann `cube-{short-id}.local` verwenden, um diese CUBE-OS-Instanz in Ihrem LAN zu identifizieren.

<div align="left"><figure><img src="/files/ed8a73441628a5fadf8ca6f5ec9beb5b1024492f" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/german/erste-schritte/quickstart/installation-mit-einem-klick/windows.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.