Configuração USB Proxmox

proxmox-USB.md

✅ Tutorial: Habilitar USB no Proxmox LXC + Docker (ESPHome)

Este guia mostra como passar um dispositivo USB (ex: CH340/ESP) do host Proxmox para:

• Um container LXC (ex: CasaOS)
• E depois para o Docker (ex: ESPHome)

---

🔍 1. Identifique o dispositivo USB no host Proxmox

lsusb
dmesg | grep tty
ls -l /dev/ttyUSB*

Você deve ver algo como:

ch341-uart converter now attached to ttyUSB0

---

🛠️ 2. Edite o container LXC no Proxmox

Substitua 101 pelo ID do seu container LXC:

nano /etc/pve/lxc/101.conf

Adicione as seguintes linhas no final:

lxc.cgroup2.devices.allow: c 188:* rwm
lxc.mount.entry: /dev/ttyUSB0 dev/ttyUSB0 none bind,optional,create=file

Salve e saia (Ctrl + X, Y, Enter).

Reinicie o container:

pct restart 101

---

✅ 3. Verifique o dispositivo USB no LXC

Dentro do container:

ls -l /dev/ttyUSB*

Se /dev/ttyUSB0 aparecer, está tudo certo.

---

🐳 4. Passar USB para o Docker (ex: ESPHome)

🧩 Com docker run:

docker run -d \
  --name esphome \
  --privileged \
  --device=/dev/ttyUSB0 \
  -v /etc/esphome:/config \
  -p 6052:6052 \
  esphome/esphome

⚠️ Ajuste o caminho /etc/esphome para onde está sua configuração.

---

📦 Com docker-compose.yml:

version: "3"
services:
  esphome:
    image: esphome/esphome
    container_name: esphome
    privileged: true
    ports:
      - "6052:6052"
    volumes:
      - /etc/esphome:/config
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0

E execute:

docker-compose up -d

---

🧪 Teste final

Dentro do container LXC (ou via terminal do Docker):

esphome run /config/seu_arquivo.yaml

✅ Agora o ESPHome poderá acessar o dispositivo USB para instalar firmware em placas ESP!