From cc799f592922837ee25186f1a9ebcd3877b5f380 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torjus=20H=C3=A5kestad?= Date: Thu, 5 Feb 2026 02:02:14 +0100 Subject: [PATCH] docs: note USB passthrough requirement for ha1 migration Co-Authored-By: Claude Opus 4.5 --- docs/plans/host-migration-to-opentofu.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/plans/host-migration-to-opentofu.md b/docs/plans/host-migration-to-opentofu.md index ddcdb15..14c66a6 100644 --- a/docs/plans/host-migration-to-opentofu.md +++ b/docs/plans/host-migration-to-opentofu.md @@ -158,6 +158,12 @@ For each stateful host, the procedure is: coordinator state in `/var/lib/zigbee2mqtt` should preserve pairings, but verify on a non-critical time window. +**USB Passthrough:** The ha1 VM has a USB device passed through from the Proxmox hypervisor +(the Zigbee coordinator). The new VM must be configured with the same USB passthrough in +OpenTofu/Proxmox. Verify the USB device ID on the hypervisor and add the appropriate +`usb` block to the VM definition in `terraform/vms.tf`. The USB device must be passed +through before starting Zigbee2MQTT on the new host. + ## Phase 5: Decommission jump Host 1. Verify nothing depends on the jump host (no SSH proxy configs pointing to it, etc.)