# VirtualBox

{% embed url="<https://www.youtube.com/watch?v=ZRNFkle69BI>" %}

### 1. Préparation :

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

Visitez ce [répo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) pour télécharger la dernière  `.vdi` image. Veuillez extraire l'image après le téléchargement.
{% endstep %}

{% step %}
**Installer la machine virtuelle**

Téléchargez et installez un gestionnaire de machines virtuelles, avec [VirtualBox](https://www.virtualbox.org/wiki/Downloads) recommandé.

<img src="/files/fdd5a61f55f5a4be1d6aca62d57e982f281d7262" alt="" data-size="original">
{% endstep %}

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

Si vous devez ajouter des appareils Zigbee, préparez une clé Zigbee (Dongle). Les clés Zigbee testées incluent :
{% endstep %}
{% endstepper %}

### 2. Créer une machine virtuelle :

{% stepper %}
{% step %}
Lancez VirtualBox

<img src="/files/93b8bfeb978630e261046e1ec0fe2d68d505a589" alt="" data-size="original">
{% endstep %}

{% step %}
Sélectionnez « Nouveau » <img src="/files/5abc6a00a1c2c91a3df8face49d39c5d2e8d06ce" alt="" data-size="line"> ou utilisez le raccourci « Ctrl + N ».&#x20;
{% endstep %}

{% step %}
Nommez la machine virtuelle, sélectionnez « Linux » comme type, « Autre Linux » comme sous-type, et « Autre Linux (64 bits) » comme version.

<img src="/files/4f6c81dd2529f986de3f1c32e852f5ddf6df5dfd" alt="" data-size="original">
{% endstep %}

{% step %}
Sous « Matériel », allouez la taille de la mémoire et le nombre de processeurs pour la machine virtuelle. 4 Go de mémoire et 2 CPU sont recommandés. Ensuite, activez l'EFI.

<img src="/files/89f217e31bb6bce11cd415cd07175687b8cba5be" alt="" data-size="original">

{% hint style="info" %}
Important : Assurez-vous que l'EFI est activé ; sinon, CUBE OS ne démarrera pas.
{% endhint %}
{% endstep %}

{% step %}
Sous « Disque dur », choisissez d'utiliser un fichier de disque dur virtuel existant et sélectionnez le fichier .vdi extrait de [Étape de préparation 1.](#id-1-preparation)

<img src="/files/e7768fdcda716cc7df13c4f574deb632b490001b" alt="" data-size="original">
{% endstep %}

{% step %}
Cliquez sur « Terminer » pour créer la machine virtuelle.
{% endstep %}
{% endstepper %}

### 3. Configurez la machine virtuelle :

{% stepper %}
{% step %}
Sélectionnez la machine virtuelle créée et cliquez sur le bouton « Paramètres » <img src="/files/c958e1b6867fce421bfa68afc50c7aedb7ecae3d" alt="" data-size="line"> .

<img src="/files/e05611bcb3373a182a4e2e31717b286c748dbdb1" alt="" data-size="original">
{% endstep %}

{% step %}
Sous l'onglet « Réseau », configurez la connexion réseau en « Adaptateur en pont » et sélectionnez l'adaptateur réseau que vous utilisez.

<img src="/files/11c6537cef225ecc7681196fa01ecb59d8d23c51" alt="" data-size="original">
{% endstep %}

{% step %}
Sous « Audio », activez le son et choisissez l'option par défaut comme contrôleur.&#x20;

<img src="/files/359bf7d8df8ee45785c25a3e116d85ff16f5e610" alt="" data-size="original">
{% endstep %}

{% step %}
**Optionnel :** Pour l'utilisation d'une clé Zigbee, insérez la clé Zigbee à cette étape et sélectionnez le type de contrôleur correct sous « USB ». Dans le filtre USB, ajoutez la clé Zigbee nécessaire à l'aide du bouton d'ajout sur le côté.

<img src="/files/1c73a1e1910188828133bd29eeffaa142c96bb70" alt="" data-size="original">
{% endstep %}

{% step %}
Cliquez sur « OK » pour enregistrer la configuration.
{% endstep %}
{% endstepper %}

### 4. Démarrer CUBE OS

{% stepper %}
{% step %}
Cliquez sur le bouton "Démarrer" <img src="/files/ffb123f0f7ac2486f077266274093addbd556b64" alt="" data-size="line">.

<img src="/files/7001a35b153aa4751abf0ef857d9e7bef08a8f28" alt="" data-size="original">
{% endstep %}

{% step %}
Surveillez l'écran de démarrage jusqu'à la fin du boot.

<img src="/files/fa20e5cd3bf7bcc900a59c2bdc43136639d01494" alt="" data-size="original">
{% endstep %}

{% step %}
Une fois terminé, vous verrez l'adresse IP de CUBE OS affichée à l'écran. Utilisez cette adresse IP ou [cube.local](http://cube.local) pour accéder à la page de gestion Web de CUBE OS.

<img src="/files/0d8c4fd564e408dd97fcb6c2a17cf88fa46d81f2" alt="" data-size="original">
{% endstep %}

{% step %}
Après un accès réussi, un identifiant court peut être consulté sur la page des paramètres. Par la suite, accédez à la page de gestion Web de CUBE OS en utilisant `cube-{short id}.local`, ce qui est utile pour différencier plusieurs instances de CUBE OS sur le même réseau local.

<img src="/files/2ef7aedfae076d08e74f441aaa7c1292fa388d61" alt="" data-size="original">
{% 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/virtualbox.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.