> 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/english-it/per-iniziare/quickstart/installazione-con-un-clic/mac.md).

# Mac

Questa guida mostra come installare CUBE OS su macOS con l’Installazione con un clic. L’installer prepara l’ambiente, crea la macchina virtuale e avvia CUBE OS per te.

{% hint style="info" %}
Questa guida segue il flusso attuale dell’installer con un clic. Alcune etichette possono variare a seconda della versione.
{% endhint %}

### 1. Preparazione

{% stepper %}
{% step %}
**Controlla il tuo Mac**

Assicurati che il tuo Mac sia pronto per l’installazione:

* **SO**: Una versione supportata di macOS
* **Rete**: Connessione internet stabile e accesso LAN
* **Permessi**: Accesso da amministratore su macOS
  {% endstep %}

{% step %}
**Scarica l’installer**

Vai alla [pagina di rilascio di CUBE OS](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) e scarica **Installazione con un clic per Mac**.

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

{% step %}
**Adattatore Zigbee (opzionale)**

Se devi aggiungere dispositivi Zigbee, prepara un dongle Zigbee. I dongle Zigbee testati includono:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Altri elencati](https://darkxst.github.io/silabs-firmware-builder/) dal sviluppatore @darkxst&#x20;

{% hint style="info" %}
Per ulteriori informazioni sulle configurazioni e la compatibilità Zigbee, consultare questo [guida](/english-it/verifica-compatibilita/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. Installa CUBE OS con l’Installazione con un clic

{% stepper %}
{% step %}
**Apri l’installer**

Trova l’installer in **Download** o nella cartella che hai scelto. Apri il pacchetto e segui i passaggi sullo schermo.

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

{% step %}
**Consenti all’installer di controllare VirtualBox**

L’installer verifica se VirtualBox è disponibile sul tuo Mac. Se VirtualBox non è installato, segui i passaggi sullo schermo per installarlo prima.

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

{% step %}
**Imposta le risorse della macchina virtuale**

Scegli il nome della macchina virtuale, la memoria e i core CPU. Impostazioni consigliate:

* **Memoria**: 2048 MB o più
* **CPU**: 2 core o più

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

{% step %}
**Seleziona un adattatore di rete in bridge**

Scegli un adattatore di rete attivo sul tuo Mac. Usa un adattatore in bridge in modo che CUBE OS possa unirsi alla tua rete locale.

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

{% step %}
**Opzionale: configura il passthrough USB**

Se usi un dongle Zigbee, seleziona il dispositivo USB dall’elenco. Se non ti serve Zigbee ora, salta questo passaggio.

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

{% step %}
**Avvia l’installazione**

L’installer crea la macchina virtuale di CUBE OS e avvia automaticamente la configurazione. Attendi il completamento dell’installazione.

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

### 3. Avvia e accedi a CUBE OS

{% stepper %}
{% step %}
**Attendi l’avvio di CUBE OS**

Dopo l’installazione, CUBE OS si avvia automaticamente. Quando l’avvio è completato, annota l’indirizzo IP di CUBE OS mostrato sullo schermo.

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

{% step %}
**Apri la console web di CUBE OS**

Apri un browser sulla stessa rete e visita uno di questi indirizzi:

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

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

{% step %}
**Usa in seguito l’indirizzo locale breve**

Dopo la configurazione, puoi trovare l’ID breve nella pagina delle impostazioni.

Puoi quindi usare `cube-{short-id}.local` per identificare questa istanza di CUBE OS sulla tua LAN.

<div align="left"><figure><img src="/files/bf53c0069d6b7af1f356647d25b9d9d18a592b3e" 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/english-it/per-iniziare/quickstart/installazione-con-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.