# Proxmox

### 1. Préparation

{% stepper %}
{% step %}
**Téléchargez l'image CUBE OS**

Visitez ce [repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) pour télécharger la dernière image CUBE OS et l'extraire après le téléchargement.

Pour Proxmox VE 9, téléchargez l'archive de l'image disque (généralement `sdcard.vmdk.xz`).

Extrayez-la pour obtenir le `.vmdk` fichier.
{% endstep %}

{% step %}
**Préparez un hôte Proxmox VE**

* Un **hôte Proxmox VE** en fonctionnement avec accès administrateur (UI Web + Shell/SSH)
* Si vous n'avez pas encore installé Proxmox VE, suivez le [guide](https://www.proxmox.com/en/products/proxmox-virtual-environment/get-started).
* Ressources recommandées pour la VM :
  * **CPU**: 2 cœurs
  * **Mémoire**: 4096 Mo (4 Go) ou plus
    {% endstep %}

{% step %}
**Adaptateur Zigbee (optionnel)**

Si vous devez ajouter des appareils Zigbee, préparez une clé Zigbee. Les clés Zigbee testées incluent :

Vous pouvez passer la clé à la VM dans Proxmox (voir la section optionnelle ci‑dessous).
{% endstep %}
{% endstepper %}

### 2. Créer une machine virtuelle (Proxmox)

{% stepper %}
{% step %}
Dans l'interface Web de Proxmox, cliquez sur **Créer VM**.

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

{% step %}
**Général -** Définissez un ID VM et un nom, par ex. `CUBE OS`.

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

{% step %}
**OS -** Choisissez **Ne pas utiliser de média**.

<div align="left"><figure><img src="/files/4259c98cd7c3e33c3c22743b416f7b439b3357ff" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
CUBE OS est fourni en tant qu'image disque préconstruite. Dans Proxmox, vous allez **importer l'image disque** puis démarrer à partir de celle‑ci.
{% endhint %}
{% endstep %}

{% step %}
**Système -** Paramètres recommandés :

* **BIOS**: `OVMF (UEFI)`
* **Disque EFI**: ajoutez un disque EFI (la taille par défaut convient)
* **Clés Pre‑Enfoll**: Décochez

<div align="left"><figure><img src="/files/5377c60368dcb6110d3f2440322125a64cc3b316" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Comme dans les guides VirtualBox/VMware, **l'UEFI est requis**. Si vous ne pouvez pas démarrer, vérifiez que le BIOS est réglé sur **OVMF (UEFI)**.
{% endhint %}
{% endstep %}

{% step %}
**Disque / CPU / Mémoire / Réseau**

* **Disque**: ne **créez pas** un nouveau disque vide. Vous importerez l'image disque CUBE OS dans la section suivante.
* **CPU**: 2 cœurs (type de CPU `hôte` recommandé)
* **Mémoire**: 4096 Mo (4 Go) ou plus
* **Réseau**:

  * **Pont**: `vmbr0` (ou votre pont LAN)
  * **Modèle**: `VirtIO (paravirtualisé)`

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

{% hint style="warning" %}
Pour la découverte sur le LAN et `cube.local` pour fonctionner de manière fiable, évitez le réseau de type NAT. Utilisez un **réseau ponté** connecté à votre LAN domestique/bureau.
{% endhint %}
{% endstep %}
{% endstepper %}

### 3. Importer l'image disque CUBE OS dans Proxmox

Vous importerez l'image CUBE OS extraite (par exemple `CUBE-OS.vmdk`) et l'attacherez comme disque de démarrage de la VM.

{% stepper %}
{% step %}
**Trouvez le stockage approprié (`local`, pas `local-lvm`).** Dans la barre latérale gauche de l'UI Web Proxmox, cliquez sur **local** (pas **local-lvm**).

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

{% step %}
**Téléversez le `.vmdk` dans `local`**

1. Cliquez sur **Importer**
2. Sélectionnez l'image disque extraite sur votre ordinateur, par exemple :
   * `sdcard.vmdk`
3. Attendez la fin du téléversement (800+ Mo peut prendre un certain temps)

<div align="left"><figure><img src="/files/1fbc0b0c7c33ce3d8429d531f298142d93bb97e3" alt="" width="563"><figcaption></figcaption></figure></div>

Une fois terminé, vous devriez voir le fichier dans la **Contenu** liste.

<div align="left"><figure><img src="/files/4d6edeb2fb5f01d6860140682b4584cbacfa40c6" alt="" width="369"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Attachez le disque importé et définissez‑le comme disque de démarrage.** Dans la VM CUBE OS :

1. Allez à **Matériel**
2. Sélectionnez le **importé** Ajouter ![](/files/aa2127e705f84c07fd3370d39a8aeb42ad21862b)**→**

<div align="left"><figure><img src="/files/b7f3c4bd66a244d60c161c13f25a6f24eab0d29c" alt="" width="556"><figcaption></figcaption></figure></div>

3. Importer disque dur **Puis allez dans** Options → Ordre de démarrage

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

### et définissez le disque importé comme premier périphérique de démarrage.

{% stepper %}
{% step %}
4\. Démarrer CUBE OS![](/files/e4ad54079a47744dcc52b684a4173229cc54a6e4) Cliquez pour **la VM et ouvrez la**.

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

{% step %}
Console

Attendez quelques instants que CUBE OS s'initialise. **Une fois le démarrage terminé, vous devriez voir l'** adresse IP

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

{% step %}
affichée sur la console.

* Ouvrir l'interface Web CUBE OS `Visitez`http\://\<CUBE\_OS\_IP>/
* , ou [Essayez :](http://cube.local)

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

<http://cube.local> `Après un accès réussi, un identifiant court peut être consulté sur la page des paramètres. Ensuite, accédez à la page de gestion Web CUBE OS en utilisant`cube-{short id}.local

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

### , ce qui est utile pour différencier plusieurs instances CUBE OS sur le même réseau local.

{% stepper %}
{% step %}
5\. (Optionnel) Passage de la clé USB Zigbee (Proxmox)
{% endstep %}

{% step %}
Branchez la clé Zigbee sur l'hôte Proxmox. **Dans la VM, allez à**.

* Matériel → Ajouter → Périphérique USB **Privilégiez la sélection par** ID fournisseur/périphérique
* (plus stable que par port si vous changez de ports USB). **Si votre clé expose une interface série, elle peut aussi apparaître sous** Ajouter → Port série

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

{% step %}
selon votre configuration.
{% 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/cube-os-fr/prise-en-main/quickstart/machine-virtuelle/proxmox.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.