# 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**.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FxS9FgoQHLLqdGBxwL1sn%2Fimage.png?alt=media&#x26;token=03d7070e-ea60-40fc-969b-8a0ed960253c" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Allgemein -** Legen Sie eine VM-ID und einen Namen fest, z. B. `CUBE OS`.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8tc2J86zFiizshwgAIyV%2Fimage.png?alt=media&#x26;token=72f4b78a-91f6-4f9f-9c90-e0bbc7a14b91" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Betriebssystem -** Wählen Sie **Kein Medium verwenden**.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQdua3l1pnrtpcc7pPDAY%2Fimage.png?alt=media&#x26;token=2b570f43-4cc3-4a4f-9c8b-11dd4f4322e7" alt="" width="563"><figcaption></figcaption></figure></div>

{% 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

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FpfdBgeDtrKo3OhYPAbXw%2Fimage.png?alt=media&#x26;token=61c86177-e2b1-4197-a73c-25ba0e54429e" alt="" width="563"><figcaption></figcaption></figure></div>

{% 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)`

  <div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6VyRJr87Bi24M9Ydjpf8%2Fimage.png?alt=media&#x26;token=12cdb23c-adc8-46ca-baa7-9990370ea565" alt="" width="375"><figcaption></figcaption></figure></div>

{% 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**).

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FiPnpG4xmGCMdIlIDGg87%2Fimage.png?alt=media&#x26;token=175030f1-f975-4664-99c7-27bb7dcdcc17" alt="" width="563"><figcaption></figcaption></figure></div>
{% 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)

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FfuXNaQrDKv2E81C1Gcqm%2Fimage.png?alt=media&#x26;token=d2cecdf6-ed34-4f9d-a029-0e407f742277" alt="" width="563"><figcaption></figcaption></figure></div>

Nachdem es fertig ist, sollten Sie die Datei in der **Inhalt** Liste sehen.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FblP4P5F1uymfIC01W0ii%2Fimage.png?alt=media&#x26;token=a532cd47-0f32-406c-a7e0-7c0860e8a35e" alt="" width="369"><figcaption></figcaption></figure></div>
{% 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** → ![](https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FHHAzYiA9dcGIaV5vySZI%2Fimage.png?alt=media\&token=bbc9c988-1529-45ee-b52b-afae61468e8e)**Festplatte importieren**

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FF69ghjcxJnIAPSqGtKWH%2Fimage.png?alt=media&#x26;token=0663b5a7-3c5f-4a76-a03a-a8a92bb73185" alt="" width="556"><figcaption></figcaption></figure></div>

3. Gehen Sie dann zu **Optionen → Boot-Reihenfolge** und setzen Sie die importierte Festplatte als erstes Boot-Gerät.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FgFpqm3Cc2iT0egyb6ruO%2Fimage.png?alt=media&#x26;token=4916ed74-486c-4fbb-a805-550141c5dbc8" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 4. CUBE OS starten

{% stepper %}
{% step %}
Klicken Sie, um![](https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FU63IlpRoEXQvlMX5UFfA%2Fimage.png?alt=media\&token=868c3c5e-174c-4b72-986d-32d3898b97a7) die VM zu starten und öffnen Sie die **Konsole**.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fp6ESYiONl9HLhsdjh5eb%2Fimage.png?alt=media&#x26;token=af9bf298-919c-4e53-8051-b2fa475f640a" alt="" width="563"><figcaption></figcaption></figure></div>
{% 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.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6DzbTjl6xb6J7QpxyiRU%2Fimage.png?alt=media&#x26;token=4fcbb889-05b1-431c-b356-a75786949d05" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Öffnen Sie die CUBE OS Web-Oberfläche

* Besuchen Sie `http://<CUBE_OS_IP>/`, oder
* Versuchen Sie: <http://cube.local>

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>

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.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" alt="" width="375"><figcaption></figcaption></figure></div>
{% 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.

<div align="left"><figure><img src="https://1528069096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FzspXAwmgdYxXVKMFNKkn%2Fimage.png?alt=media&#x26;token=71363e03-aa40-4e59-a1d2-d3e30acfe487" alt="" width="370"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Starten Sie die VM neu (falls erforderlich) und fügen Sie dann Zigbee-Geräte in CUBE OS hinzu.
{% endstep %}
{% endstepper %}