> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/cube-os-fr/prise-en-main/quickstart/installation-en-un-clic/windows.md).

# Windows

Ce guide vous montre comment installer CUBE OS sur Windows avec l’installateur en un clic. L’installateur configure VirtualBox, crée la machine virtuelle et démarre CUBE OS pour vous.

### 1. Préparation

{% stepper %}
{% step %}
**Vérifiez votre PC Windows**

Assurez-vous que votre PC répond à ces exigences :

* **SE**: Windows 10 ou Windows 11, 64 bits
* **CPU**: 2 cœurs ou plus
* **Mémoire**: 4 Go de RAM ou plus
* **Réseau**: Internet stable et accès au LAN
* **Autorisations**: Accès administrateur sur Windows
*

{% endstep %}

{% step %}
**Téléchargez l’installateur**

Rendez-vous sur la [page de publication de CUBE OS](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) et téléchargez **Installateur en un clic pour Windows**.

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

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

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

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Autres répertoriés](https://darkxst.github.io/silabs-firmware-builder/) par le développeur @darkxst&#x20;

{% hint style="info" %}
Pour plus d'informations sur les configurations et la compatibilité Zigbee, veuillez vous référer à ceci [guide](/cube-os-fr/verification-de-compatibilite/zigbee.md).
{% endhint %}

Avant de connecter l’adaptateur Zigbee à Windows, installez le pilote USB série correspondant au chipset de la clé :

* **CP210x** — [Pilotes VCP Silicon Labs CP210x USB vers UART Bridge](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
* **CH34x** — [Pilote série USB WCH CH341/CH34x](https://www.wch-ic.com/downloads/CH341SER_EXE.html)

{% hint style="info" %}
Si Windows ne détecte pas la clé dans l’installateur ou dans VirtualBox, débranchez l’adaptateur, installez le pilote, puis reconnectez-le.
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. Installer CUBE OS avec l’installateur en un clic

{% stepper %}
{% step %}
**Exécutez l’installateur en tant qu’administrateur**

Trouvez le fichier de l’installateur dans **Téléchargements** ou dans le dossier que vous avez choisi. Faites un clic droit dessus et sélectionnez **Exécuter en tant qu’administrateur**.

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

{% step %}
**Laissez l’installateur vérifier VirtualBox**

L’installateur vérifie si VirtualBox est disponible sur votre PC. Si VirtualBox n’est pas installé, suivez les étapes affichées à l’écran pour l’installer d’abord.

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

{% step %}
**Définissez les ressources de la machine virtuelle**

Choisissez le nom de la machine virtuelle, la mémoire et le nombre de cœurs CPU. Paramètres recommandés :

* **Mémoire**: 2048 Mo ou plus
* **CPU**: 2 cœurs ou plus

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

{% step %}
**Sélectionnez un adaptateur réseau ponté**

Choisissez un adaptateur réseau actif sur votre PC. Utilisez un adaptateur ponté afin que CUBE OS puisse rejoindre votre réseau local.

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

{% step %}
**Facultatif : configurer le transfert USB**

Si vous utilisez une clé Zigbee, sélectionnez l’appareil USB dans la liste. Si vous n’avez pas besoin de Zigbee pour le moment, ignorez cette étape.

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

{% step %}
**Démarrez l’installation**

L’installateur extrait les fichiers nécessaires et crée automatiquement la machine virtuelle CUBE OS. Attendez la fin du processus, puis cliquez sur **Terminer**.

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

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

### 3. Démarrer et accéder à CUBE OS

{% stepper %}
{% step %}
**Attendez le démarrage de CUBE OS**

Après l’installation, la machine virtuelle démarre automatiquement dans VirtualBox. Une fois le démarrage terminé, la console affiche l’adresse IP de CUBE OS.

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

{% step %}
**Ouvrez la console web de CUBE OS**

Ouvrez un navigateur sur le même réseau et visitez l’une de ces adresses :

* `http://<CUBE_OS_IP>/`
* <http://cube.local>

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

{% step %}
**Utilisez plus tard l’adresse locale courte**

Après la configuration, vous pouvez trouver l’identifiant court sur la page des paramètres. Vous pouvez ensuite utiliser `cube-{short-id}.local` pour identifier cette instance de CUBE OS sur votre LAN.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/cube-os-fr/prise-en-main/quickstart/installation-en-un-clic/windows.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.