Version
7.2.6
Host OS Type
macOS
Host OS name + version
macOS 26.4.1
Host Architecture
ARM
Guest OS Type
macOS
Guest Architecture
ARM
Guest OS name + version
Home Assistant OS 17.2
Component
USB and Serial Ports
What happened?
When running the VM in headless mode (VBoxManage startvm "Home Assistant" --type headless), a USB device (a Conbee II Zigbee controller) plugged into the Mac required for functionality within the VM fails to attach to the VM. When running the exact same VM via the GUI, the USB device attaches without issue.
How can we reproduce this?
I've produced this issue in two ways:
Method 1 - Preconfigured Filter
- Using the GUI, create a filter to attach the USB device to the VM
- Start the VM via the GUI, verify the USB device appears properly
- Shut down the VM, quit the GUI
- Open up Terminal
- Run
VBoxManage startvm "VM Name" --type headless
- Observe that the USB device configured in the filter fails to attach
Method 2 - Manually Attaching The USB Device
- Ensure your VM does not have any USB filters configured
- Without the GUI running, start the VM in headless mode (
VBoxManage startvm "VM Name" --type headless)
- Identify the details of the USB device connected to the host via
VBoxManage list usbhost
- Attempt to attach the USB device using the details to the running VM (
VBoxManage controlvm "VM Name" usbattach <USB Device Details>)
- Receive error message, and observe USB device fails to attach to the VM:
VBoxManage: error: Code NS_ERROR_FAILURE (0x80004005) - Operation failed (extended info not available)
VBoxManage: error: Context: "AttachUSBDevice(usbId.raw(), captureFilename.raw())" at line 1442 of file VBoxManageControlVM.cpp
See also the attached log for the log of a startup of the VM with a USB device filter that was configured via the GUI; as stated above, filter works perfectly when the VM is started via the GUI, but always fails when the VM is started via VBoxManage from the terminal.
Home Assistant-2026-04-15-20-53-47.log
Did you upload all of your necessary log files, screenshots, etc.?
Version
7.2.6
Host OS Type
macOS
Host OS name + version
macOS 26.4.1
Host Architecture
ARM
Guest OS Type
macOS
Guest Architecture
ARM
Guest OS name + version
Home Assistant OS 17.2
Component
USB and Serial Ports
What happened?
When running the VM in headless mode (
VBoxManage startvm "Home Assistant" --type headless), a USB device (a Conbee II Zigbee controller) plugged into the Mac required for functionality within the VM fails to attach to the VM. When running the exact same VM via the GUI, the USB device attaches without issue.How can we reproduce this?
I've produced this issue in two ways:
Method 1 - Preconfigured Filter
VBoxManage startvm "VM Name" --type headlessMethod 2 - Manually Attaching The USB Device
VBoxManage startvm "VM Name" --type headless)VBoxManage list usbhostVBoxManage controlvm "VM Name" usbattach <USB Device Details>)See also the attached log for the log of a startup of the VM with a USB device filter that was configured via the GUI; as stated above, filter works perfectly when the VM is started via the GUI, but always fails when the VM is started via
VBoxManagefrom the terminal.Home Assistant-2026-04-15-20-53-47.log
Did you upload all of your necessary log files, screenshots, etc.?