> 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-pt/guias-de-configuracao/executando-o-zen-studio-no-linux.md).

# Executando o Zen Studio no Linux

Siga este guia para configurar uma VM Windows no Ubuntu, Debian ou Arch Linux para instalar o Zen Studio e conectar seu Cronus Zen.

## Passo a passo

***

{% stepper %}
{% step %}

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

* **Abra o VirtualBox e clique em Novo**
  * Nome: ZenWindowsVM
  * Tipo: Microsoft Windows
  * Versão: Windows 10 (64 bits)
* **Monte o ISO do Windows**
  * Selecione VM → Configurações → Armazenamento
  * Sob o controlador IDE, clique no disco vazio
  * Escolher um arquivo de disco → selecione seu ISO
* Inicie a VM e complete o assistente de instalação do Windows
  {% endstep %}

{% step %}

### Configure a VM após a instalação

* **Windows Update**
  * Abra Configurações → Atualização e Segurança → Verificar se há atualizações.
  * Instale todas as atualizações e reinicie.
* **Guest Additions**
  * No menu da VM do VirtualBox: Dispositivos → Inserir imagem de CD das Guest Additions.
  * No Explorador do Windows, execute *VBoxWindowsAdditions.exe*
  * Reinicie.
* **Encaminhamento USB**
  * Desligue a VM.
  * **Configurações** → **USB** → habilitar **USB 2.0** or **USB 3.0** controlador, Clique + → selecione **Cronus Zen** → **OK**.
    {% endstep %}

{% step %}

### Instale o Zen Studio

* Ligue a VM Windows.

* Dentro do Windows, abra seu navegador e vá para:
  * [**collectiveminds.gitbook.io/cronuszen/mainhub/downloads**](https://collectiveminds.gitbook.io/cronuszen/mainhub/downloads)

* Baixar **Zen Studio**.

* Execute o instalador: **Avançar** → **Aceitar licença** → **Instalar** → **Concluir**.

* Se o instalador falhar ao baixar o .NET Framework 4.8.1:
  * Baixe o instalador 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)

* Execute o instalador do .NET e reinicie o Windows.

* Execute novamente o instalador do Zen Studio.
  {% endstep %}

{% step %}

### Conecte seu Cronus Zen

* Segure ambos os botões azuis do Cronus Zen.
* Conecte o Cronus Zen ao seu PC/Notebook.
* Os LEDs irão piscar.
* Agora solte ambos os botões azuis.
* No menu do VirtualBox: **Dispositivos** → **USB** → selecione **Cronus Zen**.
* No Windows, abra o ZEN Studio e confirme a detecção do dispositivo.
  {% endstep %}

{% step %}

### Dicas e solução de problemas

* Adicione seu usuário Linux ao grupo vboxusers:
  * *sudo usermod -aG vboxusers $USER*
  * Então faça logout e login novamente.
* No Arch, verifique se os módulos do kernel do VirtualBox estão carregados:
  * *sudo modprobe vboxdrv vboxnetflt vboxnetadp*
* Se o encaminhamento USB falhar:
  * Alterne entre USB 2.0 e USB 3.0 nas configurações da VM.
* Habilite nested paging e I/O APIC:
  * Sob **Sistema** → **Aceleração** para melhor desempenho.
* Para automação ou uso sem cabeça:
  * Explore **VBoxManage** para scriptar a criação de VMs e 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-pt/guias-de-configuracao/executando-o-zen-studio-no-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.