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

# Windows

Esta guía te muestra cómo instalar CUBE OS en Windows con el instalador con un clic. El instalador configura VirtualBox, crea la máquina virtual e inicia CUBE OS por ti.

### 1. Preparación

{% stepper %}
{% step %}
**Comprueba tu PC con Windows**

Asegúrate de que tu PC cumple estos requisitos:

* **SO**: Windows 10 o Windows 11, 64 bits
* **CPU**: 2 núcleos o más
* **Memoria**: 4 GB de RAM o más
* **Red**: Internet estable y acceso a LAN
* **Permisos**: Acceso de administrador en Windows
*

{% endstep %}

{% step %}
**Descarga el instalador**

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

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

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

Si necesitas añadir dispositivos Zigbee, prepara un dongle Zigbee. Los dongles Zigbee probados incluyen:

Antes de conectar el adaptador Zigbee a Windows, instala el controlador USB serie correspondiente para el chipset del dongle:

* **CP210x** — [Controladores VCP del puente USB a UART CP210x de Silicon Labs](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
* **CH34x** — [Controlador serie USB WCH CH341/CH34x](https://www.wch-ic.com/downloads/CH341SER_EXE.html)

{% hint style="info" %}
Si Windows no detecta el dongle en el instalador o en VirtualBox, desconecta el adaptador, instala el controlador y luego vuelve a conectarlo.
{% endhint %}
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}
**Ejecuta el instalador como administrador**

Busca el archivo del instalador en **Descargas** o en la carpeta que hayas elegido. Haz clic derecho y selecciona **Ejecutar como administrador**.

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

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

El instalador comprueba si VirtualBox está disponible en tu PC. Si VirtualBox no está instalado, sigue los pasos en pantalla para instalarlo primero.

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

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

Elige 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/38f4b6f2d4d69917e69bbc6b4fc8369403f5e9ac" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Selecciona un adaptador de red en puente**

Elige un adaptador de red activo en tu PC. Usa un adaptador en puente para que CUBE OS pueda unirse a tu red local.

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

{% step %}
**Opcional: Configurar passthrough de USB**

Si usas un dongle Zigbee, selecciona el dispositivo USB de la lista. Si no necesitas Zigbee ahora, omite este paso.

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

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

El instalador extrae los archivos necesarios y crea automáticamente la máquina virtual de CUBE OS. Espera hasta que finalice el proceso y luego haz clic en **Finalizar**.

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

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

### 3. Iniciar y acceder a CUBE OS

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

Después de la instalación, la máquina virtual se inicia automáticamente en VirtualBox. Cuando termine el arranque, la consola muestra la dirección IP de CUBE OS.

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

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

Abre un navegador en la misma red y visita una de estas direcciones:

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

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

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

Después de la configuración, puedes encontrar el ID corto en la página de ajustes. Luego puedes usar `cube-{short-id}.local` para identificar esta instancia de CUBE OS en tu LAN.

<div align="left"><figure><img src="/files/865966eb12d11b26f33586158381576ee4de6592" 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/windows.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.