> 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-es/primeros-pasos/quickstart/instalacion-con-un-clic/mac.md).

# Mac

Esta guía le muestra cómo instalar CUBE OS en macOS con el instalador con un clic. El instalador prepara el entorno, crea la máquina virtual e inicia CUBE OS por usted.

{% hint style="info" %}
Esta guía sigue el flujo actual del instalador con un clic. Algunas etiquetas pueden variar según la versión.
{% endhint %}

### 1. Preparación

{% stepper %}
{% step %}
**Compruebe su Mac**

Asegúrese de que su Mac esté lista para la instalación:

* **SO**: Una versión compatible de macOS
* **Red**: Conexión estable a Internet y acceso a la LAN
* **Permisos**: Acceso de administrador en macOS
  {% endstep %}

{% step %}
**Descargue el instalador**

Vaya a la [página de lanzamientos de CUBE OS](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) y descargue **Instalador con un clic para Mac**.

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

{% step %}
**Adaptador Zigbee (opcional)**

Si necesita añadir dispositivos Zigbee, prepare un dongle Zigbee. Los dongles Zigbee probados incluyen:
{% endstep %}
{% endstepper %}

### 2. Instale CUBE OS con el instalador con un clic

{% stepper %}
{% step %}
**Abra el instalador**

Encuentre el instalador en **Descargas** o en la carpeta que haya elegido. Abra el paquete y siga los pasos en pantalla.

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

{% step %}
**Deje que el instalador compruebe VirtualBox**

El instalador comprueba si VirtualBox está disponible en su Mac. Si VirtualBox no está instalado, siga primero los pasos en pantalla para instalarlo.

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

{% step %}
**Configure los recursos de la máquina virtual**

Elija el nombre de la máquina virtual, la memoria y los núcleos de CPU. Configuración recomendada:

* **Memoria**: 2048 MB o más
* **CPU**: 2 núcleos o más

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

{% step %}
**Seleccione un adaptador de red en modo puente**

Elija un adaptador de red activo en su Mac. Use un adaptador en modo puente para que CUBE OS pueda unirse a su red local.

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

{% step %}
**Opcional: configure el paso a través de USB**

Si usa un dongle Zigbee, seleccione el dispositivo USB de la lista. Si ahora no necesita Zigbee, omita este paso.

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

{% step %}
**Inicie la instalación**

El instalador crea la máquina virtual de CUBE OS e inicia la configuración automáticamente. Espere hasta que finalice la instalación.

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

### 3. Arranque y acceda a CUBE OS

{% stepper %}
{% step %}
**Espere a que CUBE OS se inicie**

Después de la instalación, CUBE OS se inicia automáticamente. Cuando termine el arranque, anote la dirección IP de CUBE OS que se muestra en pantalla.

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

{% step %}
**Abra la consola web de CUBE OS**

Abra un navegador en la misma red y visite una de estas direcciones:

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

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

{% step %}
**Use la dirección local corta más adelante**

Después de la configuración, puede encontrar el ID corto en la página de ajustes.

Luego puede usar `cube-{short-id}.local` para identificar esta instancia de CUBE OS en su LAN.

<div align="left"><figure><img src="/files/57cda30d7925d1d5c0e369f51bc693d271a5ec7f" 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:

```
GET https://cube.ewelink.cc/cube-os-es/primeros-pasos/quickstart/instalacion-con-un-clic/mac.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.