# VirtualBox

{% embed url="<https://www.youtube.com/watch?v=ZRNFkle69BI>" %}

### 1. Preparación:

{% stepper %}
{% step %}
**Descargue el** CUBE OS **imagen**

Visite este [repositorio](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) para descargar la última  `.vdi` imagen. Por favor extraiga la imagen después de descargarla.
{% endstep %}

{% step %}
**Instalar Máquina Virtual**

Descargue e instale un administrador de máquinas virtuales, con [VirtualBox](https://www.virtualbox.org/wiki/Downloads) siendo recomendado.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FaRb8fgybrqGWHbtYS7YU%2FScreenshot%202024-11-15%20133236.png?alt=media&#x26;token=54f2c0f8-d8f6-4ecb-a3f9-400521078928" alt="" data-size="original">
{% endstep %}

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

Si necesita agregar dispositivos Zigbee, prepare un Dongle Zigbee. Dongles Zigbee probados incluyen:
{% endstep %}
{% endstepper %}

### 2. Crear una Máquina Virtual:

{% stepper %}
{% step %}
Inicie VirtualBox

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZGI9rJk8IUxEdgk3npBQ%2FScreenshot%202024-11-15%20175848.png?alt=media&#x26;token=1966adf2-b3d5-42d0-9896-56d5ccebc601" alt="" data-size="original">
{% endstep %}

{% step %}
Seleccione “Nuevo” <img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FoNVMloCDlR1eHIbFH3zx%2FScreenshot%202024-11-18%20at%2015.03.19.png?alt=media&#x26;token=586123c1-ea41-4a98-9bb7-7d77cf06af8c" alt="" data-size="line"> o use el atajo “Ctrl + N”.
{% endstep %}

{% step %}
Nombre la máquina virtual, seleccione “Linux” como tipo, “Other Linux” como subtipo y “Other Linux (64 bit)” como versión.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fbi2Agh2bcH28tGqszTr3%2FScreenshot%202024-11-15%20175947.png?alt=media&#x26;token=12f50209-ea01-4a50-8102-56714e01dc79" alt="" data-size="original">
{% endstep %}

{% step %}
En “Hardware”, asigne el tamaño de memoria y la cantidad de procesadores para la máquina virtual. Se recomiendan 4 GB de memoria y 2 CPU. Luego, habilite EFI.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fo92nbBZaaLAmS2rolN9I%2FScreenshot%202024-11-15%20180009.png?alt=media&#x26;token=b25ab9c3-4f48-4a32-b562-2041d0cf5586" alt="" data-size="original">

{% hint style="info" %}
Importante: Asegúrese de que EFI esté habilitado; de lo contrario, CUBE OS no arrancará.
{% endhint %}
{% endstep %}

{% step %}
En “Disco duro”, elija usar un archivo de disco duro virtual existente y seleccione el archivo .vdi extraído de [Paso 1 de Preparación.](#id-1-preparation)

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FAjeZx31FP1Rn7liZNbNZ%2FScreenshot%202024-11-15%20180529.png?alt=media&#x26;token=90a1a7ff-a8ad-4bc8-a089-753736235af1" alt="" data-size="original">
{% endstep %}

{% step %}
Haga clic en “Finalizar” para crear la máquina virtual.
{% endstep %}
{% endstepper %}

### 3. Configure la Máquina Virtual:

{% stepper %}
{% step %}
Seleccione la máquina virtual creada y haga clic en el <img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FbCq5o9wm5cZdaXqZgccV%2FScreenshot%202024-11-18%20at%2015.19.16.png?alt=media&#x26;token=7427dab3-d960-4840-87d8-e9cc2c744919" alt="" data-size="line"> botón “Configuración”.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F0PSwNRH0LaXpjrpXNFzy%2FScreenshot%202024-11-18%20151129.png?alt=media&#x26;token=a556ce67-64d0-4392-a780-cc757a60c462" alt="" data-size="original">
{% endstep %}

{% step %}
En la pestaña “Red”, configure la conexión de red como “Adaptador puente” y seleccione el adaptador de red que esté utilizando.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FOGiUj6l2kVAaaV1PPymk%2FScreenshot%202024-11-15%20180610.png?alt=media&#x26;token=ed4d08ae-a349-47ae-a9d5-0ae426cd4eec" alt="" data-size="original">
{% endstep %}

{% step %}
En “Audio”, habilite el sonido y elija la opción Predeterminada como el controlador.&#x20;

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FMm18yjdoBCAdBrW9LfPG%2FScreenshot%202024-11-18%20151206.png?alt=media&#x26;token=7c32ee24-cf6c-4d5f-9275-65a0e3665c37" alt="" data-size="original">
{% endstep %}

{% step %}
**Opcional:** Para el uso del Dongle Zigbee, inserte el Dongle Zigbee en este paso y seleccione el tipo de controlador correcto en “USB”. En el filtro USB, agregue el Dongle Zigbee necesario usando el botón de agregar en el lateral.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fc9DMGFIHx7v78szyPBrI%2FScreenshot%202024-11-18%20151754.png?alt=media&#x26;token=f785e096-8cf4-40c4-aa9d-d509c952c616" alt="" data-size="original">
{% endstep %}

{% step %}
Haga clic en “Aceptar” para guardar la configuración.
{% endstep %}
{% endstepper %}

### 4. Iniciar CUBE OS

{% stepper %}
{% step %}
Haga clic en el botón "Iniciar" <img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fclrx0CtpJQxoVq5wOL9j%2FScreenshot%202024-11-18%20at%2015.23.20.png?alt=media&#x26;token=3f60b611-86a8-4e2f-917d-96d776d71c8a" alt="" data-size="line">.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F2t6UwuTSigCxRm4IjKQg%2FScreenshot%202024-11-18%20151129%20copy.png?alt=media&#x26;token=6d622e6c-88e3-4020-bf93-a49989fa6482" alt="" data-size="original">
{% endstep %}

{% step %}
Monitoree la pantalla de arranque hasta que el proceso termine.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQwVa8ZvQR1dReJTIzIsb%2FScreenshot%202024-11-18%20152604.png?alt=media&#x26;token=439aa522-de74-4147-84a7-6c02c0fac499" alt="" data-size="original">
{% endstep %}

{% step %}
Una vez completado, verá la IP de CUBE OS mostrada en la pantalla. Use esta dirección IP o [cube.local](http://cube.local) para acceder a la página de administración web de CUBE OS.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZbb6mFwPaMSDIRqzexaK%2FScreenshot%202024-11-15%20180746.png?alt=media&#x26;token=8bffc2eb-f774-4ac7-8916-1d04c07e405f" alt="" data-size="original">
{% endstep %}

{% step %}
Al acceder con éxito, se puede ver un ID corto en la página de configuración. Posteriormente, acceda a la página de administración web de CUBE OS usando `cube-{short id}.local`, lo cual es útil para diferenciar múltiples instancias de CUBE OS en la misma red local.

<img src="https://1438513814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FXJi8azaU8jWkoxymkz8K%2FScreenshot%202024-11-18%20at%2011.33.14.png?alt=media&#x26;token=eb4c5fc2-307f-41d9-b0c7-ccefb6d3ad73" alt="" data-size="original">
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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/maquina-virtual/virtualbox.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.