# 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**.
{% endstep %}
{% step %}
**Général -** Définissez un ID VM et un nom, par ex. `CUBE OS`.
{% endstep %}
{% step %}
**OS -** Choisissez **Ne pas utiliser de média**.
{% 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
{% 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é)`
{% 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**).
{% 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)
Une fois terminé, vous devriez voir le fichier dans la **Contenu** liste.
{% 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 **→**
3. Importer disque dur **Puis allez dans** Options → Ordre de démarrage
{% endstep %}
{% endstepper %}
### et définissez le disque importé comme premier périphérique de démarrage.
{% stepper %}
{% step %}
4\. Démarrer CUBE OS Cliquez pour **la VM et ouvrez la**.
{% endstep %}
{% step %}
Console
Attendez quelques instants que CUBE OS s'initialise. **Une fois le démarrage terminé, vous devriez voir l'** adresse IP
{% endstep %}
{% step %}
affichée sur la console.
* Ouvrir l'interface Web CUBE OS `Visitez`http\://\/
* , ou [Essayez :](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
{% 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
{% endstep %}
{% step %}
selon votre configuration.
{% endstep %}
{% endstepper %}
