# Esecuzione di Zen Studio su Linux

Segui questa guida per configurare una VM Windows su Ubuntu, Debian o Arch Linux per installare Zen Studio e collegare il tuo Cronus Zen.

## Passo dopo passo

***

{% stepper %}
{% step %}

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

* **Apri VirtualBox e clicca su Nuova**
  * Nome: ZenWindowsVM
  * Tipo: Microsoft Windows
  * Versione: Windows 10 (64-bit)
* **Monta l'ISO di Windows**
  * Seleziona VM → Impostazioni → Archiviazione
  * Sotto il controller IDE, clicca sul disco vuoto
  * Scegli un file disco → seleziona la tua ISO
* Avvia la VM e completa la procedura guidata di installazione di Windows
  {% endstep %}

{% step %}

### Configura la VM dopo l'installazione

* **Windows Update**
  * Apri Impostazioni → Aggiornamento e sicurezza → Verifica disponibilità aggiornamenti.
  * Installa tutti gli aggiornamenti e riavvia.
* **Guest Additions**
  * Nel menu della VM di VirtualBox: Dispositivi → Inserisci l'immagine del CD delle Guest Additions.
  * In Esplora file di Windows, esegui *VBoxWindowsAdditions.exe*
  * Riavvia.
* **Pass-through USB**
  * Spegni la VM.
  * **Impostazioni** → **USB** → abilita **USB 2.0** o **USB 3.0** controller, clicca + → seleziona **Cronus Zen** → **OK**.
    {% endstep %}

{% step %}

### Installa Zen Studio

* Accendi la VM Windows.

* All'interno di Windows, apri il browser e vai a:
  * [**collectiveminds.gitbook.io/cronuszen/mainhub/downloads**](https://collectiveminds.gitbook.io/cronuszen/mainhub/downloads)

* Scarica **Zen Studio**.

* Esegui il programma di installazione: **Avanti** → **Accetta la licenza** → **Installa** → **Fine**.

* Se l'installatore fallisce durante il download di .NET Framework 4.8.1:
  * Scarica l'installatore offline da Microsoft
    * [**dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer**](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer)

* Esegui l'installatore di .NET e riavvia Windows.

* Esegui nuovamente l'installatore di Zen Studio.
  {% endstep %}

{% step %}

### Collega il tuo Cronus Zen

* Tieni premuti entrambi i pulsanti blu del Cronus Zen.
* Collega il Cronus Zen al tuo PC/portatile.
* I LED lampeggeranno.
* Ora rilascia entrambi i pulsanti blu.
* Nel menu di VirtualBox: **Dispositivi** → **USB** → seleziona **Cronus Zen**.
* In Windows, avvia ZEN Studio e conferma il riconoscimento del dispositivo.
  {% endstep %}

{% step %}

### Suggerimenti e risoluzione dei problemi

* Aggiungi il tuo utente Linux al gruppo vboxusers:
  * *sudo usermod -aG vboxusers $USER*
  * Quindi disconnettiti e riconnettiti.
* Su Arch, assicurati che i moduli del kernel di VirtualBox siano caricati:
  * *sudo modprobe vboxdrv vboxnetflt vboxnetadp*
* Se il pass-through USB fallisce:
  * Alterna tra USB 2.0 e USB 3.0 nelle impostazioni della VM.
* Abilita il paging annidato e l'I/O APIC:
  * Sotto **Sistema** → **Accelerazione** per migliori prestazioni.
* Per automazione o uso headless:
  * Esplora **VBoxManage** per automatizzare la creazione di VM e i filtri USB.
    {% 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://guide.cronuszen.com/zen-it/guide-di-configurazione/esecuzione-di-zen-studio-su-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.