murilogteixeira · July 22, 2025 02:02 · Jul 22, 2025
diff --git a/proxmox-USB.md b/proxmox-USB.md
@@ -0,0 +1,114 @@
+# ✅ 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
+
+```bash
+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:
+
+```bash
+nano /etc/pve/lxc/101.conf
+```
+
+Adicione as seguintes linhas no final:
+
+```ini
+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:
+
+```bash
+pct restart 101
+```
+
+---
+
+## ✅ 3. Verifique o dispositivo USB no LXC
+
+Dentro do container:
+
+```bash
+ls -l /dev/ttyUSB*
+```
+
+Se `/dev/ttyUSB0` aparecer, está tudo certo.
+
+---
+
+## 🐳 4. Passar USB para o Docker (ex: ESPHome)
+
+### 🧩 Com `docker run`:
+
+```bash
+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`:
+
+```yaml
+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:
+
+```bash
+docker-compose up -d
+```
+
+---
+
+## 🧪 Teste final
+
+Dentro do container LXC (ou via terminal do Docker):
+
+```bash
+esphome run /config/seu_arquivo.yaml
+```
+
+✅ Agora o ESPHome poderá acessar o dispositivo USB para instalar firmware em placas ESP!