> For the complete documentation index, see [llms.txt](https://guide.cronuszen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.cronuszen.com/zen-es/guias-de-configuracion/ejecutar-zen-studio-en-linux.md).

# Ejecutar Zen Studio en Linux

Sigue esta guía para configurar una VM de Windows en Ubuntu, Debian o Arch Linux para instalar Zen Studio y conectar tu Cronus Zen.

## Paso a paso

***

{% stepper %}
{% step %}

### Crear la VM de Windows <a href="#sc6aw" id="sc6aw"></a>

* **Abre VirtualBox y haz clic en Nuevo**
  * Nombre: ZenWindowsVM
  * Tipo: Microsoft Windows
  * Versión: Windows 10 (64 bits)
* **Montar el ISO de Windows**
  * Selecciona VM → Configuración → Almacenamiento
  * Bajo el controlador IDE, haz clic en el disco vacío
  * Elegir un archivo de disco → selecciona tu ISO
* Inicia la VM y completa el asistente de instalación de Windows
  {% endstep %}

{% step %}

### Configurar la VM después de la instalación

* **Actualización de Windows**
  * Abre Configuración → Actualización y seguridad → Buscar actualizaciones.
  * Instala todas las actualizaciones y reinicia.
* **Guest Additions**
  * En el menú de la VM de VirtualBox: Dispositivos → Insertar imagen de CD de Guest Additions.
  * En el Explorador de Windows, ejecuta *VBoxWindowsAdditions.exe*
  * Reinicia.
* **Passthrough USB**
  * Apaga la VM.
  * **Configuración** → **USB** → habilitar **USB 2.0** or **USB 3.0** controlador, Haz clic en + → selecciona **Cronus Zen** → **Aceptar**.
    {% endstep %}

{% step %}

### Instalar Zen Studio

* Enciende la VM de Windows.

* Dentro de Windows, abre tu navegador y ve a:
  * [**collectiveminds.gitbook.io/cronuszen/mainhub/downloads**](https://collectiveminds.gitbook.io/cronuszen/mainhub/downloads)

* Descargar **Zen Studio**.

* Ejecuta el instalador: **Siguiente** → **Aceptar licencia** → **Instalar** → **Finalizar**.

* Si el instalador falla al descargar .NET Framework 4.8.1:
  * Descarga el instalador sin conexión desde Microsoft
    * [**dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer**](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer)

* Ejecuta el instalador de .NET y reinicia Windows.

* Vuelve a ejecutar el instalador de Zen Studio.
  {% endstep %}

{% step %}

### Conecta tu Cronus Zen

* Mantén pulsados ambos botones azules del Cronus Zen.
* Conecta el Cronus Zen a tu PC/portátil.
* Los LEDs parpadearán.
* Ahora suelta ambos botones azules.
* En el menú de VirtualBox: **Dispositivos** → **USB** → selecciona **Cronus Zen**.
* En Windows, inicia ZEN Studio y confirma la detección del dispositivo.
  {% endstep %}

{% step %}

### Consejos y solución de problemas

* Agrega tu usuario de Linux al grupo vboxusers:
  * *sudo usermod -aG vboxusers $USER*
  * Luego cierra sesión y vuelve a iniciarla.
* En Arch, asegúrate de que los módulos del kernel de VirtualBox estén cargados:
  * *sudo modprobe vboxdrv vboxnetflt vboxnetadp*
* Si el passthrough USB falla:
  * Alterna entre USB 2.0 y USB 3.0 en la configuración de la VM.
* Habilita nested paging y I/O APIC:
  * Bajo **Sistema** → **Aceleración** para un mejor rendimiento.
* Para automatización o uso sin interfaz gráfica:
  * Explora **VBoxManage** para automatizar la creación de VMs y los filtros USB.
    {% 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://guide.cronuszen.com/zen-es/guias-de-configuracion/ejecutar-zen-studio-en-linux.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.