> 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/mac.md).

# Mac

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

{% hint style="info" %}
Ce guide suit le flux actuel de l’installateur en un clic. Certaines étiquettes peuvent varier selon la version.
{% endhint %}

### 1. Préparation

{% stepper %}
{% step %}
**Vérifiez votre Mac**

Assurez-vous que votre Mac est prêt pour l’installation :

* **OS** : une version de macOS prise en charge
* **Réseau** : un accès Internet et LAN stable
* **Autorisations** : un accès administrateur sur macOS
  {% endstep %}

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

Accédez à la [page de publication de CUBE OS](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) et téléchargez **l’installateur en un clic pour Mac**.

<div align="left"><figure><img src="/files/2b32204ec69e467f01f5b5e852eabc9b5560a370" 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 comprennent :

> 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 %}
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}
**Ouvrez l’installateur**

Trouvez l’installateur dans **Téléchargements** ou dans le dossier de votre choix. Ouvrez le paquet et suivez les étapes à l’écran.

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

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

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

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

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

Choisissez le nom de la machine virtuelle, la mémoire et les 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/15c2567e9bf14afcc13b367b5f13fb2a50beef9e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

Choisissez un adaptateur réseau actif sur votre Mac. Utilisez un adaptateur en mode pont pour que CUBE OS puisse rejoindre votre réseau local.

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

{% step %}
**Facultatif : configurer la redirection USB**

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

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

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

L’installateur crée la machine virtuelle CUBE OS et lance automatiquement la configuration. Attendez la fin de l’installation.

<div align="left"><figure><img src="/files/f3e079bb44e087f6bbe3e036055a91f5822c264c" 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, CUBE OS démarre automatiquement. Une fois le démarrage terminé, notez l’adresse IP de CUBE OS affichée à l’écran.

<div align="left"><figure><img src="/files/e265f50cc9ed33e1abae790817bb754bd99c08cc" alt="" width="365"><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/d9524aeda2d97e88add4eb295e8daa941b35aa56" 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/2a0d3b3587268f80a9b3e6f08857867e78181bf3" 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/mac.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.