# Proxmox
### 1. Vorbereitung
{% stepper %}
{% step %}
**Laden Sie das CUBE OS-Image herunter**
Besuchen Sie dieses [Repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) um das neueste CUBE OS-Image herunterzuladen und nach dem Herunterladen zu entpacken.
Für Proxmox VE 9 laden Sie das Festplatten-Image-Archiv herunter (üblicherweise `sdcard.vmdk.xz`).
Entpacken Sie es, um die `.vmdk` Datei zu erhalten.
{% endstep %}
{% step %}
**Bereiten Sie einen Proxmox VE-Host vor**
* Ein laufender **Proxmox VE** Host mit Administratorzugang (Web UI + Shell/SSH)
* Wenn Sie Proxmox VE noch nicht installiert haben, folgen Sie dem offiziellen [Leitfaden](https://www.proxmox.com/en/products/proxmox-virtual-environment/get-started).
* Empfohlene Ressourcen für die VM:
* **CPU**: 2 Kerne
* **Arbeitsspeicher**: 4096 MB (4 GB) oder mehr
{% endstep %}
{% step %}
**Zigbee-Adapter (Optional)**
Wenn Sie Zigbee-Geräte hinzufügen möchten, bereiten Sie einen Zigbee-Dongle vor. Getestete Zigbee-Dongles umfassen:
Sie können den Dongle in Proxmox an die VM durchreichen (siehe den optionalen Abschnitt unten).
{% endstep %}
{% endstepper %}
### 2. Erstellen einer virtuellen Maschine (Proxmox)
{% stepper %}
{% step %}
Klicken Sie in der Proxmox Web UI auf **VM erstellen**.
{% endstep %}
{% step %}
**Allgemein -** Legen Sie eine VM-ID und einen Namen fest, z. B. `CUBE OS`.
{% endstep %}
{% step %}
**Betriebssystem -** Wählen Sie **Kein Medium verwenden**.
{% hint style="info" %}
CUBE OS wird als vorgefertigtes Festplatten-Image bereitgestellt. In Proxmox werden Sie **das Festplatten-Image importieren** und dann davon booten.
{% endhint %}
{% endstep %}
{% step %}
**System -** Empfohlene Einstellungen:
* **BIOS**: `OVMF (UEFI)`
* **EFI-Disk**: fügen Sie eine EFI-Festplatte hinzu (Standardgröße ist in Ordnung)
* **Pre-Enfoll-Schlüssel**: Deaktivieren Sie
{% hint style="info" %}
Wie in den VirtualBox/VMware-Anleitungen **ist UEFI erforderlich**. Wenn Sie nicht booten können, überprüfen Sie nochmals, ob das BIOS auf **OVMF (UEFI)**.
{% endhint %}
{% endstep %}
{% step %}
**Festplatte / CPU / Arbeitsspeicher / Netzwerk**
* **Festplatte**: erstellen Sie **nicht** eine neue leere Festplatte. Sie werden das CUBE OS-Festplatten-Image im nächsten Abschnitt importieren.
* **CPU**: 2 Kerne (CPU-Typ `host` empfohlen)
* **Arbeitsspeicher**: 4096 MB (4 GB) oder mehr
* **Netzwerk**:
* **Bridge**: `vmbr0` (oder Ihre LAN-Bridge)
* **Modell**: `VirtIO (paravirtualisiert)`
{% hint style="warning" %}
Damit LAN-Erkennung und `cube.local` zuverlässig funktionieren, vermeiden Sie NAT-ähnliches Networking. Verwenden Sie ein **gebridge tes** Netzwerk, das mit Ihrem Heim-/Büro-LAN verbunden ist.
{% endhint %}
{% endstep %}
{% endstepper %}
### 3. Importieren des CUBE OS-Festplatten-Images in Proxmox
Sie werden das entpackte CUBE OS-Image importieren (zum Beispiel `CUBE-OS.vmdk`) und es als Bootlaufwerk der VM anhängen.
{% stepper %}
{% step %}
**Finden Sie den richtigen Speicher (`lokal`, nicht `local-lvm`).** Klicken Sie in der linken Seitenleiste der Proxmox Web UI auf **lokal** (nicht **local-lvm**).
{% endstep %}
{% step %}
**Laden Sie die `.vmdk` hoch in `lokal`**
1. Klicken Sie auf **Importieren**
2. Wählen Sie das entpackte Festplatten-Image auf Ihrem Computer aus, zum Beispiel:
* `sdcard.vmdk`
3. Warten Sie, bis der Upload abgeschlossen ist (800+ MB kann eine Weile dauern)
Nachdem es fertig ist, sollten Sie die Datei in der **Inhalt** Liste sehen.
{% endstep %}
{% step %}
**Hängen Sie die importierte Festplatte an und setzen Sie sie als Bootlaufwerk.** In der CUBE OS-VM:
1. Gehen Sie zu **Hardware**
2. Wählen Sie die importierte **Hinzufügen** → **Festplatte importieren**
3. Gehen Sie dann zu **Optionen → Boot-Reihenfolge** und setzen Sie die importierte Festplatte als erstes Boot-Gerät.
{% endstep %}
{% endstepper %}
### 4. CUBE OS starten
{% stepper %}
{% step %}
Klicken Sie, um die VM zu starten und öffnen Sie die **Konsole**.
{% endstep %}
{% step %}
Warten Sie einen Moment, bis CUBE OS initialisiert ist.
Nach dem Abschluss des Starts sollten Sie die **IP-Adresse** auf der Konsole angezeigt sehen.
{% endstep %}
{% step %}
Öffnen Sie die CUBE OS Web-Oberfläche
* Besuchen Sie `http:///`, oder
* Versuchen Sie:
Nach erfolgreichem Zugriff kann auf der Einstellungsseite eine kurze ID angezeigt werden. Anschließend greifen Sie auf die CUBE OS-Webverwaltungsseite zu über `cube-{short id}.local`, was nützlich ist, um mehrere CUBE OS-Instanzen im selben lokalen Netzwerk zu unterscheiden.
{% endstep %}
{% endstepper %}
### 5. (Optional) Zigbee USB-Dongle-Durchreichung (Proxmox)
{% stepper %}
{% step %}
Stecken Sie den Zigbee-Dongle in den Proxmox-Host.
{% endstep %}
{% step %}
Gehen Sie in der VM zu **Hardware → Hinzufügen → USB-Gerät**.
* Wählen Sie vorzugsweise nach **Vendor/Device-ID** (stabiler als nach Port, wenn Sie USB-Ports wechseln).
* Wenn Ihr Dongle eine serielle Schnittstelle bereitstellt, kann er je nach Einrichtung auch unter **Hinzufügen → Serieller Anschluss** erscheinen.
{% endstep %}
{% step %}
Starten Sie die VM neu (falls erforderlich) und fügen Sie dann Zigbee-Geräte in CUBE OS hinzu.
{% 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/proxmox.md?ask=
```
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.
