1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
(devices-usb)=
# Type: `usb`
```{note}
The `usb` device type is supported for both containers and VMs.
It supports hotplugging for both containers and VMs.
```
USB devices make the specified USB device appear in the instance.
For performance issues, avoid using devices that require high throughput or low latency.
For containers, only `libusb` devices (at `/dev/bus/usb`) are passed to the instance.
This method works for devices that have user-space drivers.
For devices that require dedicated kernel drivers, use a [`unix-char` device](devices-unix-char) or a [`unix-hotplug` device](devices-unix-hotplug) instead.
For virtual machines, the entire USB device is passed through, so any USB device is supported.
When a device is passed to the instance, it vanishes from the host.
## Device options
`usb` devices have the following device options:
% Include content from [config_options.txt](../config_options.txt)
```{include} ../config_options.txt
:start-after: <!-- config group devices-usb start -->
:end-before: <!-- config group devices-usb end -->
```
|
