# Proxmox
### 1. Preparação
{% stepper %}
{% step %}
**Baixe a imagem do CUBE OS**
Visite este [repositório](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) para baixar a versão mais recente da imagem do CUBE OS e extraí‑la após o download.
Para Proxmox VE 9, baixe o arquivo de imagem de disco (comumente `sdcard.vmdk.xz`).
Extraia para obter o `.vmdk` arquivo.
{% endstep %}
{% step %}
**Prepare um host Proxmox VE**
* Um **Proxmox VE** host com acesso de administrador (UI Web + Shell/SSH)
* Se você ainda não instalou o Proxmox VE, siga o [guia](https://www.proxmox.com/en/products/proxmox-virtual-environment/get-started).
* Recursos recomendados para a VM:
* **CPU**: 2 núcleos
* **Memória**: 4096 MB (4 GB) ou mais
{% endstep %}
{% step %}
**Adaptador Zigbee (Opcional)**
Se precisar adicionar dispositivos Zigbee, prepare um Dongle Zigbee. Dongles Zigbee testados incluem:
Você pode encaminhar o dongle para a VM no Proxmox (veja a seção opcional abaixo).
{% endstep %}
{% endstepper %}
### 2. Crie uma Máquina Virtual (Proxmox)
{% stepper %}
{% step %}
Na UI Web do Proxmox, clique em **Criar VM**.
{% endstep %}
{% step %}
**Geral -** Defina um ID e um nome para a VM, por exemplo `CUBE OS`.
{% hint style="info" %}
O CUBE OS é fornecido como uma imagem de disco pré‑construída. No Proxmox, você **importará a imagem de disco** e então irá inicializar a partir dela.
{% endhint %}
{% endstep %}
{% step %}
**Sistema -** Configurações recomendadas:
* **BIOS**: `OVMF (UEFI)`
* **Disco EFI**: adicione um disco EFI (o tamanho padrão está OK)
* **Chaves Pre-Enfoll**: Desmarque
{% hint style="info" %}
Assim como nos guias do VirtualBox/VMware, **UEFI é obrigatório**. Se você não conseguir inicializar, verifique se a BIOS está configurada para **OVMF (UEFI)**.
{% endhint %}
{% endstep %}
{% step %}
**Disco / CPU / Memória / Rede**
* **Disco**: não **crie um novo disco vazio. Você importará a imagem de disco do CUBE OS na próxima seção.** : 2 núcleos (tipo de CPU
* **CPU**host `recomendado)` Rede
* **Memória**: 4096 MB (4 GB) ou mais
* **Bridge**:
* **vmbr0**: `(ou sua bridge de LAN)` Modelo
* **VirtIO (paravirtualizado)**: `Para descoberta na LAN e`
{% hint style="warning" %}
cube.local `funcionarem de forma confiável, evite redes em estilo NAT. Use uma` conexão em bridge **conectada à sua LAN doméstica/escritório.** 3. Importe a imagem de disco do CUBE OS para o Proxmox
{% endhint %}
{% endstep %}
{% endstepper %}
### Você importará a imagem extraída do CUBE OS (por exemplo
CUBE-OS.vmdk `) e a anexará como o disco de inicialização da VM.`Encontre o armazenamento correto (
{% stepper %}
{% step %}
**local`, não`local-lvm `Na barra lateral esquerda da UI Web do Proxmox, clique em`).** (não **, não** Envie o **Na barra lateral esquerda da UI Web do Proxmox, clique em**).
{% endstep %}
{% step %}
**para `.vmdk` Clique em `, não`**
1. Importar **Selecione a imagem de disco extraída no seu computador, por exemplo:**
2. sdcard.vmdk
* `Aguarde o upload concluir (800+ MB pode demorar um pouco)`
3. Depois que terminar, você deverá ver o arquivo na lista de
Conteúdo **.** Anexe o disco importado e defina‑o como disco de inicialização.
{% endstep %}
{% step %}
**Na VM do CUBE OS:** Vá para
1. Hardware **Selecione o**
2. importado **Adicionar** → **Importar Disco Rígido**
3. Então vá para **Opções → Ordem de Inicialização** e defina o disco importado como o primeiro dispositivo de inicialização.
{% endstep %}
{% endstepper %}
### 4. Inicialize o CUBE OS
{% stepper %}
{% step %}
Clique para a VM e abra o **Console**.
{% endstep %}
{% step %}
Aguarde alguns instantes para o CUBE OS inicializar.
Uma vez que a inicialização esteja completa, você deverá ver o **endereço IP** exibido no console.
{% endstep %}
{% step %}
Abra a UI Web do CUBE OS
* Visite `http:///`, ou
* Tente:
Ao acessar com sucesso, um ID curto pode ser visto na página de configurações. Em seguida, acesse a página de gerenciamento Web do CUBE OS usando `cube-{short id}.local`, o que é útil para diferenciar várias instâncias do CUBE OS na mesma rede local.
{% endstep %}
{% endstepper %}
### 5. (Opcional) Encaminhamento de Dongle USB Zigbee (Proxmox)
{% stepper %}
{% step %}
Conecte o dongle Zigbee ao host Proxmox.
{% endstep %}
{% step %}
Na VM, vá para **Hardware → Adicionar → Dispositivo USB**.
* Prefira selecionar por **ID do Vendor/Device** (mais estável do que por porta caso você mova as portas USB).
* Se seu dongle expõe uma interface serial, ele também pode aparecer em **Adicionar → Porta Serial** dependendo da sua configuração.
{% endstep %}
{% step %}
Reinicie a VM (se necessário) e então adicione dispositivos Zigbee no CUBE OS.
{% 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/english-pt-br/introducao/quickstart/maquina-virtual/proxmox.md?ask=
```
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.
