> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/english-pt/primeiros-passos/quickstart/maquina-virtual/proxmox.md).

# Proxmox

### 1. Preparação

{% stepper %}
{% step %}
**Faça o download da imagem CUBE OS**

Visite este [repositório](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) para baixar a imagem mais recente 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-o 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 você precisar adicionar dispositivos Zigbee, prepare um Dongle Zigbee. Dongles Zigbee testados incluem:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Outros listados](https://darkxst.github.io/silabs-firmware-builder/) pelo desenvolvedor @darkxst 

{% hint style="info" %}
Para obter mais informações sobre configurações e compatibilidade do Zigbee, consulte este [guia](/english-pt/verificacao-de-compatibilidade/zigbee.md).
{% endhint %}

Você pode passar 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**.

<div align="left"><figure><img src="/files/59eecb5232d8687a0c5436b0ec7d6295b18d9fe5" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Geral -** Defina um ID de VM e um nome, por exemplo `CUBE OS`.

<div align="left"><figure><img src="/files/8aed20d28995bd1b28e0ae213c0297695dd87604" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Sistema operacional -** Escolha **Não use nenhuma mídia**.

<div align="left"><figure><img src="/files/b3f677b56c53cea189234ad9ad4b64a76ce58d06" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
O CUBE OS é fornecido como uma imagem de disco pré‑construída. No Proxmox, você irá **importar a imagem de disco** e então inicializar a partir dela.
{% endhint %}
{% endstep %}

{% step %}
**Sistema -** Configurações recomendadas:

* **BIOS**: `OVMF (UEFI)`
* **Disco EFI**: adicione um disco EFI (o tamanho padrão é suficiente)
* **Chaves Pre‑Enfoll**: Desmarcar

<div align="left"><figure><img src="/files/bbd36297a7580de809b0fdb17ff2353646521386" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Assim como nos guias do VirtualBox/VMware, **UEFI é obrigatório**. Se você não conseguir inicializar, verifique novamente se a BIOS está definida para **OVMF (UEFI)**.
{% endhint %}
{% endstep %}

{% step %}
**Disco / CPU / Memória / Rede**

* **Disco**: não faça **criar 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 LAN)` Modelo
  * **VirtIO (paravirtualizado)**: `Para descoberta na LAN e`

  <div align="left"><figure><img src="/files/98a98110d0e206d318c82c0ab788d1dbd0c33f73" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
cube.local `funcionarem de forma confiável, evite redes no estilo NAT. Use uma` rede 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**).

<div align="left"><figure><img src="/files/8328048ec8a8a6e9243430603f4c186db46828f8" alt="" width="563"><figcaption></figcaption></figure></div>
{% 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 ser concluído (800+ MB pode demorar um pouco)`
3. Depois que terminar, você deverá ver o arquivo na

<div align="left"><figure><img src="/files/00c2f400f42c3d367c8b3a3e696b9c0d25080ae9" alt="" width="563"><figcaption></figcaption></figure></div>

Lista de **Conteúdo** .

<div align="left"><figure><img src="/files/e2b4dc1a3f194ddff168e83b37d4eb421c0c854d" alt="" width="369"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Anexe o disco importado e defina‑o como disco de boot.** Na VM do CUBE OS:

1. Vá para **Hardware**
2. Selecione o **importado** Adicionar ![](/files/fb732d244ee5b67b6ac5d604f5245a1dee8feafe)**→**

<div align="left"><figure><img src="/files/94fce9ef38b1a5a9e6bdf2d49d8ee50d646ad99f" alt="" width="556"><figcaption></figcaption></figure></div>

3. Importar Disco Rígido **Em seguida, vá para** Opções → Ordem de Inicialização

<div align="left"><figure><img src="/files/c891d2fb581f1ab9b0a4620e54f8d9d9d66a825d" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### e defina o disco importado como o primeiro dispositivo de inicialização.

{% stepper %}
{% step %}
4\. Inicializar o CUBE OS![](/files/e15448688944188535e4b8343ca69234b2696bb9) Clique para **na VM e abra o**.

<div align="left"><figure><img src="/files/e72495bf0c031d4bf4ae46b7898b7c4080d2fa1f" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Console

Aguarde alguns instantes para o CUBE OS inicializar. **Quando a inicialização for concluída, você deverá ver o** endereço IP

<div align="left"><figure><img src="/files/339abb895cceff62faf5679e2fe1f2bb7484bb79" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
exibido no console.

* Abra a UI Web do CUBE OS `Visite`http\://\<CUBE\_OS\_IP>/
* , ou [Tente:](http://cube.local)

<div align="left"><figure><img src="/files/ab4a2892db70ba91c665e346473c914533c5170a" alt="" width="375"><figcaption></figcaption></figure></div>

<http://cube.local> `Após o acesso bem‑sucedido, um ID curto pode ser visualizado na página de configurações. Posteriormente, acesse a página de gerenciamento Web do CUBE OS usando`cube-{short id}.local

<div align="left"><figure><img src="/files/daeee6b79d796f6f6ea0eb43957957e64706a3d9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### , o que é útil para diferenciar várias instâncias do CUBE OS na mesma rede local.

{% stepper %}
{% step %}
5\. (Opcional) Encaminhamento de Dongle USB Zigbee (Proxmox)
{% endstep %}

{% step %}
Conecte o dongle Zigbee ao host Proxmox. **Na VM, vá para**.

* Hardware → Adicionar → Dispositivo USB **Prefira selecionar por** ID do Vendor/Dispositivo
* (mais estável do que por porta se você trocar as portas USB). **Se o seu dongle expuser uma interface serial, ele também pode aparecer em** Adicionar → Porta Serial

<div align="left"><figure><img src="/files/ceacfb54f591f7c8fbad85066a65d8fd56aae9b9" alt="" width="370"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
dependendo da sua configuração.
{% 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, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/english-pt/primeiros-passos/quickstart/maquina-virtual/proxmox.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.